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INTRODUCTION 

RSX-11M/M-PLUS Utilities and Commands instructs you in the 
facilities of the RSX-11M operating system, one of many operating 
systems run on a PDP-11. Each module discusses a primary feature 
of RSX-11M that should be mastered, as well as the objectives, 
resources, and laboratory exercises needed to learn the material. 



COURSE DESCRIPTION 

This self-paced version of RSX-11M/M-PLUS Utilities and 
Commands is the first operating system specific course in the 
RSX-11M/M-PLUS course string. It is the base for all higher level 
RSX courses. It instructs system managers, operators, programmers 
and other users how to interact with the operating system to 
perform basic daily work functions. 

Major course topics covered: 

• How to log on and off the system and issue commands that 
provide system information. 

• Use interactive editors and file maintenance utilities to 
create and maintain file collections. 

• Use of compilers/assemblers and other utilities to develop 
MACRO-11 and FORTRAN programs. 

• Use of indirect command files to control interactive job 
execution. 

• Use of file and volume maintenance utilities to prepare 
new volumes, and to back up user files. 
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PREREQUISITES 

1. Knowledge of the concepts of minicomputer organizations as 
in the DIGITAL course, Introduction to Minicomputers, 
audio/visual or lecture/lab format, 

2. Knowledge of PDP-11 organization and programming as in the 
DIGITAL course, PDP-11 Concepts for High-Level Language 
Programmers . 



COURSE GOALS 

1. Knowledge of RSX-11M/M-PLUS terminology and operating 
philosophy. 

2. Ability to find information in the system documentation, 

3. Use a terminal to communicate with the system. 

4. Create and maintain files. 

5. Assemble, compile and task-build supplied programs. 

6. Maintain a file directory. 

7. Control the execution of supplied programs. 

8. Create, maintain and use libraries. 

9. Perform tasks needed to use private disk and tape volumes. 
NONGOALS 

1. This course does not teach the MCR command language. Some 
MCR commands are referenced in a particular table. If you 
wish to learn MCR, do so in the lab. 

2. You will not learn the syntax rules of FORTRAN and MACRO, 
or how to write a FORTRAN or MACRO program. It is assumed 
that you are familiar with the syntax structure of either 
FORTRAN or MACRO-11. 
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COURSE RESOURCES 

The following are available resources: 

1. This Student Workbook. 

2. Operating system information files provided by the HELP 
command . 

3. RSX-11M/M-PLUS Documentation Set manuals. 

4. On-line example files and indirect command files supplied 
by your instructor . 

5. Your fellow students — sharing ideas and questions is 
rewarding . 

6. Your instructor. 

The following documentation is essential to the course: 

1. Introduction to RSX-11M and RSX-11M-PLUS 

2. RSX-11M/M-PLUS Command Language Manual 

3. MCR Operations Manual 

4. Utilities Manual 

5. Task Builder Manual 

6. EDT Editor Reference Card 



5 



STUDENT GUIDE 



COURSE ORGANIZATION 

This is a self-paced course with laboratory sessions and 
written exercises. In place of a teacher you have a course 
administrator and a subject matter expert. In some cases, the 
same person may perform both functions. The course administrator 
manages the mechanics of this course. He makes sure you have easy 
access to the system and the on-line course materials. As you 
finish modules, he records your progress. The subject matter 
expert will answer any technical questions. Before you consult 
the expert, however, read the course materials and references in 
an effort to answer the question yourself. 

The Student Workbook is divided into modules which consist 

of: 

• An introduction, which describes the purpose (s) of the 
module and motivation for meeting its objectives. 

• One or more objectives, which describe operations you 
should be able to perform when you have completed the 
module . 

• A list of resources you may require to complete the 
module . 

• The module text, which includes the following elements: 

Descriptive text. 

Illustrations, which clarify the relationships among 
various elements of a RSX-11M/M-PLUS system, or 
summarize steps of a particular process. 

Tables, which summarize the operations covered by the 
module, and list the commands you enter to perform 
those operations. 

Examples, containing sample listings from actual 
terminal sessions. 

• Laboratory exercises, available in a separate book, which 
provide the practice needed to master the module 
objectives. Solutions to the exercises are also provided. 
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COURSE MAP 

The course map shows how each module of the course is related 
to the other modules and to the course as a whole. Prerequisite 
modules are those whose arrows in the map point into a module and 
should be accomplished before proceeding to the next module. 
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HOW TO TAKE THIS COURSE 

Because this is a self-paced course, you determine how much 
time to devote to each subject. You can quickly cover familiar 
topics. You can spend more time on topics which are of more 
interest or use to you in your job, and less time on topics of 
little use. 

Whenever you are ready for a new module, read the 
introduction and the objectives. If you feel you already 
understand the material in the module, you can go immediately to 
the Tests and Exercises for that module. If you do not understand 
much of the material, read the module. The text explains new 
concepts and refers you to related readings in the supplementary 
manuals. The listings provide typical examples of the operations 
that a user performs. 

Some of the readings in the manuals are essential and others 
are optional. If you feel that you need no further clarification 
on a topic, skip the reading. However, if it is a topic you wish 
to pursue, an appropriate reading reference is provided. 

As you study the module, keep the module objectives in mind. 
If a skill is listed as an objective, be sure to master it. Later 
modules may depend on this skill. 

While you are reading through the module, try the commands 
being discussed on your own terminal. This interactive way of 
learning will help your understanding of the command. Practice 
the commands repeatedly until you fully understand their function. 

The files needed for this course are located in UFD [201,1] 
on your system disk. If they are not there, check with your 
course administrator to find out where they are located. Do not 
modify the files in UFD [201,1]. Instead, copy the files to your 
own UFD and use them there. In this way, the original files 
remain intact for the next student. 

Once you have read the modules and done the learning 
activities, you can do the lab exercises. The solutions are 
included in the Test and Exercises book. 

Once you have mastered the objectives of a module, the course 
administrator will record your progress on the progress plotter 
below. Then, you are ready to begin a new module. Otherwise, 
return to the module text for further study. 

The time that you spend on this self-paced course is 
dependent upon your experience and interest in the topic as well 
as time spent experimenting with the system. Use Table 1 as a 
guide when you set your schedule. 
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PERSONAL PROGRESS PLOTTER 



Date Date Time Sign-Off 

Started Completed Spent Initial 



1. RSX-11M/M-PLUS 
System Overview 










2. Getting Started 
on the System 










3. Creating and 

Modifying Files 










4. File and Directory 
Maintenance 










5. Program Development 










6. Using the Editor 
Effectively 










7. Using Indirect 
Command Files 










8. Controlling Task 
Execution 










9. Libraries 










10. Advanced Maintenance 
Operations 
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Table 1 Typical Course Schedule 



Module 



RSX-11M/M-PLUS 
System Overview 

Getting Started 
on the System 

Creating and 
Modifying Files 

File and Directory 
Maintenance 



More Experienced 
Student 

^^^^^^^^^ 



Less Experienced 
Student 



6.0 



5.0 



5. 5 



5 Program Development 

6 Using the Editor 
Effectively 

7 Using Indirect 
Command Files 

8 Controlling Task 
Execution 



4 

3.5 



6.0 
4.5 

5.0 
5.0 



9 Libraries 

10 Advanced Maintenance 
Operations 



4.5 
5. 5 



Total Hours Study and Lab 40.0 



53. 
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RSX-1 1M-PLUS CURRICULUM 

The RSX-11M/M-PLUS curriculum is illustrated in the Course 
String below. 

After completing this course, depending upon your final 
objective, you should take the System Management course, and 
either Programming in FORTRAN IV or Programming in MACRO-11. One 
or the other is a prerequisite for Programming RSX-11M in 
FORTRAN/MACRO, which is available in both lecture/lab and 
self-paced formats. To derive the most benefit from a higher 
level language course, the prerequisite courses must be taken. 
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COURSE STRING 



RSX-11M 
DEVICE DRIVER 



EY-J2550-A0 
I 



RSX-11M 

OPERATING 

SYSTEM 

INTERNALS 

EY-J2552-A0 



DESIGN OF 
APPLICATIONS 
UNDER RSX 
EY-J2484-A0 



PROGRAMMING 
RSX-11M IN 
FORTRAN/MACRO 

EY-J2556-A0 



RSX-11M 
SYSTEM 
MANAGEMENT 

EY-J2554-A0 











I 


PROGRAMMING 
IN FORTRAN IV 

EY-J0016-A0 




PROGRAMMING 
IN MACRO-11 

EY-J2050-A0 



RSX-1 1M/M-PLUS 
UTILITIES AND 
COMMANDS 

EY-J2536-A0 



PDP-11 CONCEPTS 



EY-J2048-A0 



INTRODUCTION TO 
MINICOMPUTERS 



EY-J2016-A0 



TK-7819 
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RSX-1 1M/M-PLUS 
SYSTEM OVERVIEW 



RSX-11M/M-PLUS SYSTEM OVERVIEW 



INTRODUCTION 

Every computing system is designed for a purpose. This 
purpose determines how the system component parts are assembled to 
make a unit workable. The RSX-11M/M-PLUS Operating Systems were 
designed to solve real-time problems, those often requiring 
complete dedication to the computer's resources. This module 
explains : 

1. How the operating system keeps track of your program 

2. How it allocates the CPU and memory to your program when 
requested to run 

3. How it decides who gets CPU time and memory space when 
programs are competing for these resources. 



An understanding of the processing philosophy of this 
operating system will help you compare the differences between 
this and other operating systems used with PDP-11 hardware. 

OBJECTIVES 

List the characteristics of the RSX-11M/M-PLUS operating 
system. 

List the facilities available with RSX-11M/M-PLUS and the 
documentation provided. 

Describe the resource management techniques used by 
RSX-11M/M-PLUS for CPU and memory. 

List the various states of an RSX-11M/M-PLUS task and how 
each affect task execution. 

State the difference between a mapped and unmapped 
operating system. 

Define the terms virtual and physical address and state 
how they apply to a task and physical memory. 



1. 
2. 
3. 
4. 
5. 
6. 
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RESOURCES 

In order to complete this unit, you must have access to the 
following document: 

Introduction to RSX-11M and RSX-11M-PLUS 
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OVERVIEW 

A computer system consists of two essential components, the 
hardware and the software. 



The Hardware 

The hardware can consist of any combination of a CPU, memory 
and peripheral devices depending upon your site requirements. One 
important feature of the PDP-11 hardware architecture is the 
ability to easily add peripheral devices to a configuration, but 
only the devices necessary to a given application. Like a 
fingerprint, each PDP-11 hardware configuration can be unique. In 
addition to a Central Processing Unit (CPU) , memory, and a 
communications link between all the hardware devices, the system 
may have a mix of the following devices: 

- Disk drives 
Floppy disk drives 
Magnetic tape drives 
Hardcopy terminals 

- CRTs 

Line printers 

Paper tape readers and punches 
A/D converters 

- Communication Interfaces 



The Software 

The hardware alone is not enough to make a computer a useful 
tool. Without software to allow the printer to print, a terminal 
to send and receive data, and a magnetic tape drive to capture 
information, the hardware would remain just hardware. It is the 
software coupled with the hardware that makes the computer a 
useful tool. In general, the software is the instructions 
(programs) executed by the computer system to perform a perticular 
function . 
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THE OPERATING SYSTEM 

Having the hardware and software alone does not guarantee 
rapid, easy development and execution of programs. An additional 
element is needed to tie these two together. Coordinating the 
many activities and features of the hardware and software, and 
managing these resources at computer speeds is the task of the 
operating system. 

An operating system is a collection of programs that 
organizes a set of hardware devices into a working unit which 
people can use. It generally consists of two parts: 

An Executive 

A set of System Utilities 



The Executive acts as the primary interface between the 
hardware and a program running on the system, and between the 
program and the people who run the program. The basic functions 
of the Executive are: 

- Scheduling of the CPU 
Allocation of physical memory 
User/hardware interface 

- Device/data management 
Program processing facilities 



There are many operating systems that will execute on the 
PDP-11 hardware. Table 1-1 lists those that are currently 
supplied by Digital Equipment Corporation. Each was developed for 
a particular processing environment. 



LEARNING ACTIVITY 

For further information regarding each 
operating system, READ the respective 
chapters in the PDP-11 Software Handbook. 
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Table 1-1 PDP-11 Operating Systems 
Description 

Real-Time Operating System for PDP-11 Processors. 

A small, single-user foreground/background system 
that can support a real-time application job's 
execution in the foreground, and an interactive or 
batch program development job in the background. 

DIGITAL Standard MUMPS Operating System for 
PDP-11 Processors. 

A small- to large-size timesharing system that 
offers a unique fast access data storage and 
retrieval system for large data base processing; 
originally designed for medical record management 
and now available for similar data base applications. 

Resource-Sharing Timesharing System/Extended 
Operating System for PDP-11 Processors. 

A moderate- to large-size time-sharing system that 
can support up to 63 concurrent jobs, including 
interactive terminal user jobs, detached jobs, and 
batch processing. 

Real-Time System Executive Operating System for 
PDP-11 Processors. 

A small-to moderate-sized real-time multiprogramming 
system that can be generated for a wide range of 
application environments -- from small, dedicated 
systems to large, multipurpose real-time application 
and program development systems. 

Real-Time System Executive Operating System-PLUS 
for high-end PDP-11 Processors. 

A large real-time system that takes advantage of 
the enhanced hardware features and larger memory 
available on the PDP-11/23-PLUS/24/44/70 processors. 
(RSX-11M-PLUS is a superset of RSX-11M.) 
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Table 1-1 PDP-11 Operating Systems (Cont) 
Name Description 

RSX-11S Real-Time Multiprogramming Executive Operating 

System for PDP-11 Processors. 

A small, execute-only member of the RSX-11 family 
for dedicated real-time multiprogramming applica- 
tions (requires a host RSX-11M, RSX-11M-PLUS , IAS 
or VAX/VMS system) . 

IAS Interactive Application System for PDP-11 Processors 

A large multiuser time-sharing system, allowing real 
time application execution concurrent with time- 
shared interactive and batch processing. 
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THE RSX-1 1M-PLUS OPERATING SYSTEM 

Every operating system's architecture is built around some 
processing philosophy. The RSX-11M/M-PLUS operating systems are 
two of many operating systems that will execute on the PDP-11 
hardware. Your organization purchased the RSX-11M/M-PLUS 
operating system because its processing philosophy fits the 
application for which it was purchased. The following list shows 
the characteristics of the RSX-1 1M/M-PLUS operating system. 



RSX-1 1M/M-PLUS Characteristics 



• Real-Time - The operating system is designed primarily to 
handle the execution of real-time tasks as opposed to 
tasks that lend themselves to a time-sharing system. 
Real-time tasks are critical tasks that need exclusive use 
of the system resources on short notice and until they are 
no longer needed. In this type of a system, a task gains 
control of the CPU by priority and keeps CPU control until 
it completes, aborts, or some significant event occurs. 
Also, when the system is not servicing real-time tasks, 
the CPU's idle time can be divided into time slices and 
shared among tasks that lend themselves to a time-sharing 
environment, such as editing programs. 



• Multiprogramming - RSX-11M/M-PLUS allows more than one 
task to be resident in memory and competing for CPU time. 
The CPU is the most important resource in a computer 
system. Having many tasks resident in memory at the same 
time minimizes CPU idle time. 



• Multiuser - RSX-11M/M-PLUS allows more than one person to 
be able to use the system at one time. Each individual 
can be sitting at a terminal performing work, and it will 
appear that the system is dedicated to him alone. 
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Interactive - Being able to talk directly to the operating 
system allows the user to interact with each step in a 
process. It can be verified that the step was executed 
correctly before proceeding on to the next step. This 
flexibility is not available in a batch system, where the 
complete job stream is executed whether or not there was 
an error in the first step. 



Disk-Based - The tasks that make up the RSX-11M/M-PLUS 
operating systems are resident on a disk pack, and read 
into memory from this disk when needed. The disk is also 
used to temporarily store tasks when freeing up memory 
space for higher-priority tasks. It also provides a file 
structure for maintaining user programs and other files. 



Intertask Communication - A task executing under the 
RSX-11M/M-PLUS operating system has the ability to pass 
data on to another task, can cause another task to begin 
execution, and can notify another task that a certain 
event has occurred. 
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RSX-1 1M/M-PLUS Components 

Although we generally think of an operating system as a 
single entity, it is really comprised of smaller pieces that are 
closely associated with each other. The two major groupings of 
these pieces are the Executive and the supporting utilities. 

The Executive is the root of the operating system and is 
always resident in memory. It is made up of the following parts: 

• Executive 

- CPU Scheduler 
Memory Allocator 

System Services (Directives) 

System Software: 

Command Line Interpreters 

DCL 
MCR 

User-supplied 

- FILES-11 Data and File Manager 
Device Drivers 

The second group, supporting utilities, only becomes memory- 
resident when a request for its services is made. 

• Supporting Utilities comprise: 

- Program Development Tools 

TEXT Editors (EDI, EDT) 
MACRO-11 Assembler 
Task Builder 
Librarian 

System Macro Source, Object, and Universal 
Libraries 
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High-Level Languages (Optional) 

FORTRAN IV 

FORTRAN IV-PLUS 

FORTRAN-77 

COBOL 

BASIC-11 

BASIC-PLUS-2 



- File Maintenance Tools 

Backup and Restore Utility (BRU) 
Peripheral Interchange Program (PIP) 
File Transfer Program (FLX) 
Print and Queue Utility 
Queue Manager (QMG) 



- Volume Maintenance Tools 

Disk Volume Formatter (FMT) 

Bad Block Locator Utility (BAD) 

File Structure Verification Utility (VFY) 

File Dump Utility (DMP) 

Disk Save and Compress (DSC) 



Program Maintenance Tools 

File Compare Utility (CMP) 
Source Language Input Program (SLP) 
Object Module Patch Utility (PAT) 
Task/File Patch Program (ZAP) 



24 



RSX-11M/M-PLUS SYSTEM OVERVIEW 



Documentation 

A complete set of documents is supplied with each operating 
system that DIGITAL ships. The documents contain information on 
all the facilities available to the user. There are seven volumes 
in the set, each containing one or more manuals. Their 
organization is shown in Figure 1-1. Sheet three of this figure 
shows the documentation available for languages that are available 
under separate license. Your computer center will only have the 
documentation for those languages which you have purchased. For 
your convenience, Figure 1-2 indicates the recommended sequence 
for reading the manuals. You should read the 

RSX-11M/M-PLUS Information Directory first. The release notes 
will provide information on changes in the operating system that 
are included in this version. 
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VOLUME 1: INTRODUCTION 
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VOLUME 2: OPERATION 




VOLUME 3: UTILITIES 



Figure 1-1 The Documentation (Sheet 1 of 3) 
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SYSTEM LOGIC 
MANUAL 



VAX-11/RSX-11M 
USER'S GUIDE 



VAX-11/RSX-11M 
PROGRAMMER'S 
REFERENCE MANUAL 



PDP-11 COBOL 
LANGUAGE REFERENCE 
MANUAL 



COBOL USER'S 
GUIDE 



COBOL POCKET 
GUIDE 



COBOL INSTALLATION 
GUIDE 



PDP-11 FORTRAN 
LANGUAGE REFERENCE 
MANUAL 

PDP-11 FORTRAN 
LANGUAGE REFERENCE 
MANUAL 



FORTRAN IV 
USER'S GUIDE 



FORTRAN -77 
USER'S GUIDE 



FORTRAN IV 

INSTALLATION 

GUIDE 



FORTRAN -77 

INSTALLATION 

GUIDE 



FORTRAN-77 
OBJECT TIME SYSTEM 
REFERENCE MANUAL 



BASIC-11 LANGUAGE 

REFERENCE 

MANUAL 



BASIC USER'S 
GUIDE 



BASIC INSTALLATION 
GUIDE 



BASIC-PLUS-2 
LANGUAGE MANUAL 



BASIC-PLUS-2 
USER'S GUIDE 
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INSTALLATION 
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RSX-1 1M/RSX-1 1S INFORMATION 
DIRECTORY AND INDEX 
RSX-1 1M/RSX-11S RELEASE NOTES 



INTRODUCTION 
TO RSX-1 1M AND RSX-1 1M-PLUS 



RSX-1 1M/M-PLUS 
COMMAND LANGUAGE MANUAL 



RSX-1 1M/M-PLUS 
MCR OPERATIONS MANUAL 



RSX-1 1M/M-PLUS UTILITIES MANUAL 

RSX-1 1M/M-PLUS 
BATCH AND QUEUE OPERATIONS MANUAL 

EDT EDITOR REFERENCE MANUAL 



RSX-1 1M/M-PLUS 
GUIDE TO PROGRAM DEVELOPMENT 
PDP-11 MACRO-11 LANGUAGE 
REFERENCE MANUAL 
RSX-1 1M/M-PLUS TASK BUILDER MANUAL 
IAS/RSX-11 ODT REFERENCE MANUAL 



IAS/RSX-11 
SYSTEM LIBRARY ROUTINES 
REFERENCE MANUAL 



I 



RSX-1 1M/M-PLUS 
EXECUTIVE REFERENCE MANUAL 




RSX-1 1M/M-PLUS 
ERROR LOGGING MANUAL 

RSX-1 1M/M-PLUS 
CRASH DUMP ANALYZER REFERENCE 
MANUAL 










IAS/RSX-11 
I/O OPERATIONS REFERENCE MANUAL 

RSX-1 1M/M-PLUS 
I/O DRIVERS REFERENCE MANUAL 

RSX-1 1M 

GUIDE TO WRITING AN I/O DRIVER 




RMS-11 USER'S GUIDE 
RMS-11 INSTALLATION GUIDE 
RMS-11 MACRO-11 REFERENCE MANUAL 





RSX-1 1M 
SYSTEM GENERATION 
AND INSTALLATION GUIDE 

RSX-1 1M/M-PLUS 
SYSTEM MANAGEMENT GUIDE 



Figure 1-2 Sequence for Reading Manuals 
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Other Resources 

In addition to the system documentation set, the following 
are other resources to increase your system knowledge. 

1. RSX-11 Technical Summary - A technical introduction to 
many aspects of the three RSX real-time operating systems 
including information and Digital Support Services 
available with RSX systems. 

2. PDP-11 Processor Handbook - A discussion of the various 
features of each PDP-11 CPU, the instruction set, UNIBUS, 
programming techniques, memory management, commercial 
instruction set and instruction timing. 

3. PDP-11 Software Handbook - A discuss^ion of the major 
operating systems, programming languages, file and record 
management, data base management, utilities and 
interprocessor communication available on the PDP-11. 

4. DECUS - The Digital Equipment Computer User's Society - A 
worldwide association of customers and employees providing 
a forum for the exchange of useful information, new 
program packages and other innovations. (Membership is 
free to owners of DIGITAL computers.) 
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THE OPERATING SYSTEM 

Before the operating system can be loaded into the computer's 
memory, your system manager (the person responsible for the 
operation and maintenance of the system) goes through a procedure 
called system generation (SYSGEN) . This procedure builds the 
operating system, and fine tunes it with the hardware and software 
requirements of your computing site. At the end of the SYSGEN, 
the executable image of the operating system is written to a disk 
called the system disk. To start the computer operation, this 
executable image must be loaded into memory and an instruction 
issued to start the operating system executing in the central 
processor. This procedure is called "booting the system". 



Memory Use 

One of the resources that the operating system must manage is 
memory. Figure 1-3 shows how memory is used. Depending upon the 
operating system and the hardware, the amount of memory that can 
be connected can range from 16KW to 2MW. The operating system 
always resides in the low addresses of memory, and can range in 
size from 16KW to 20KW, depending on the software and hardware 
options generated in the SYSGEN process. Part of that 20KW 

(maximum) is an area called Pool or Dynamic Storage Region (DSR) 
set aside for the dynamic storage of executive data structures 

(These are little lists that the operating system uses to keep 
track of information about tasks and devices.) The top 4KW of 
physical memory addresses are reserved for the I/O page and are 
not available for general use. The remainder of memory is 
available for user programs. 



120000 



MEMORY 



I/O PAGE 



POOL (DSR) 



RSX-1 1M/M-PLUS 
EXEC 



} 



4K WORDS 



> R R = REMAINDER FOR 
USE BY THE 
USER 

) N 16K < N < 20K 



TK-7700 



Figure 1-3 Memory Use 
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Tasks 

The smallest executable piece of code on this operating 
system is a task. Tasks are problem solutions that have been 
processed through the program development cycle producing an 
executable task image (Figure 1-4) . For this problem solution to 
execute in the CPU a user must make a request to the operating 
system to run that program. It is the operating system's 
responsibility to locate the task image on disk, check the 
availability of memory space, load the task into memory, and 
schedule the task to run. 



Examples of tasks: 

- Payroll Program 
Text Editor 

- FORTRAN Compiler 

- Monitor Console Routine 

- File Maintenance Program 
Data Analysis Program 



A task is built with two (or many) 
operating system uses to schedule that task 
priority at which the task will run and the 
it will be loaded (partition) . Before a 
system, the operating system must know this 
about it. 



attributes that the 
to run. These are the 
area in memory where 
task can be run on the 
information (and more) 
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DEFINE THE 
PROBLEM TO 
BE SOLVED 



I 



DESIGN THE 
SOLUTION TO 
THE PROBLEM 



CODE THE 
SOLUTION TO 
THE PROBLEM 



ENTER CODE 
INTO THE 
COMPUTER WITH 
EDITOR 



ASSEMBLE/ 
COMPILE THE 
CODE 



I 



LINK THE OBJECT 
MODULES TOGETHER 



I 



DEBUG THE 
PROGRAM 



EXECUTABLE 
TASK 



TK-7699 



gure 1-4 A Task is the Result of Program Development 
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Steps Required to Run a Task 

1. A request-to-run must be issued for the task. 

2. System checks to see if it "knows" this task. 

3. System adds the task to a list of active tasks competing 
for resources. 

4. Task image must be loaded into memory from disk. 

5. Task is scheduled for CPU time. 



The System Task Directory (STD) 

The operating system maintains a list of known tasks within 
the area called Pool. This data structure is called the System 
Task Directory (Figure 1-5) which is a linked list of another data 
structure called the Task Control Block (TCB) . The TCB contains 
such task information as the task name, the priority at which it 
will run, the location in memory where it will be loaded, and the 
disk address where the task executable image can be found. All 
tasks to be run on the system must have this information recorded 
in the STD. This process is called installing a task and is 
accomplished by the INSTALL operating system command. (Installing 
a task does not cause it to run.) Some tasks are permanently 
installed, and others temporarily installed in the STD for the 
time they are executing. 



Active Task List (ATL) 

When a user requests a task to be run, the operating system 
creates an entry into another data structure maintained in Pool 
called the Active Task List (Figure 1-6) . This is a list of all 
tasks competing for the system resources (i.e., someone requested 
the task to run) at any one time. 
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MEMORY 



I/O PAGE 



120000 



P.A. 




> DSR 



> EXEC 



STD 



TCB 



TCB 



TCB 



NAME = ...LDR 
PRI = 248. 
PAR = LDRPAR 
DISK ADDR = 
LBO: -01240437 



NAME = ...DCL 
PRI = 160. 
PAR = GEN 
DISK ADDR = 
SYO: -01132456 



NAME = URTSK 
PRI = 70. 
PAR = GEN 
DISK ADDR = 
SYO: -01265347 




TCB 



TCB 



TCB 



NAME = ... EDT 




NAME = ... MAC 






PRI = 65. 




PRI = 50. 







PAR = GEN 
DISK ADDR = 





PAR = GEN 
DISK ADDR = 








(END OF LIST) 


LBO: -01254476 




SYO: -00000557 







Figure 1-5 System Task Directory 
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MEMORY 




120000 



> DSR 



> EXEC 



P.A. 



TCB 



STD 



ATL 



NAME = . . . LDR 
PRI = 248. 
PAR = LDRPAR 
DISK ADDR = 
LBO: -01240437 



TCB 



DCL 



NAME = . 
PRI = 160. 
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NAME = URTSK 
PRI = 70. 
PAR = GEN 
DISK ADDR = 
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TCB 



TCB 



TCB 



NAME = . . . EDT 




NAME = . . . MAC 






PRI = 65. 


► 


PRI = 50. 







PAR = GEN 




PAR = GEN 




(END OF 


DISK ADDR = 




DISK ADDR = 




LIST) 


LBO: -01254476 




SYO: -00000557 


r 





Figure 1-6 Active Task List 
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Allocating Memory to a Task 

Before a task can gain control of the CPU and begin 
executing, it must be resident in memory. In other words, the 
operating system must determine the addresses where the task will 
be loaded into memory and then check to see if those addresses are 
available for use. Tasks compete for memory space by the task's 
priority and the partition of memory in which it has been built to 
run. A task can be built with a priority from 1 to 250. 
Real-time tasks are generally given a priority within the range of 
150 - 250. 250 is the highest priority. Most tasks run at a 
priority of 50, which is the default priority for a task. 



Figure 1-7 shows the priority range; notice that the Digital 
Command Language (DCL) runs at a priority of 248, while the Editor 
runs at a priority of 65. This means that when the operating 
system is looking for a task to run in the CPU, it will choose the 
Task Loader over the Editor if both are competing for the CPU. 



PRIORITY RANGE 
FOR TIME 
CRITICAL TASKS 



LESS IMPORTANT 
MORE FREQUENTLY 
USED TASKS 



250. 
248. 

200. 



160. 



150. 



65. 



50. 



TASK LOADER ( ... LDR) 



MAGNETIC TAPE 
PROCESSOR (MTAACP) 



DIGITAL COMMAND LANGUAGE ( ... DCL) 
MONITOR CONSOLE ROUTINE ( ... MCR) 



EDITOR ( ... EDT) 

FILE MAINTENANCE TASK ( 

DEFAULT PRIORITY 
FOR A TASK 



PIP) 



PRIORITY 



Figure 1-7 Tasks are Built with a Priority 
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Partitions 

Tasks also compete for memory space depending upon the 
partition in which they were built to run. A partition (Figure 
1-8) is a contiguous section of memory. The operating system 
takes up 16 to 20KW of low memory addresses, and the I/O page 
takes up the top 4KW. During SYSGEN, the system manager, taking 
into account your site requirements, divides up the remaining 
portion of memory into sections giving them a name, starting 
address, size and type. These sections of memory, called 
partitions, can be changed by the system manager when necessary. 



In Figure 1-8 there are six partitions listed. Tasks can be 
loaded into each of these partitions. For example, DRVPAR is a 
special partition in which the code loads that controls the 
operation of devices (such as your terminal, disk drives, etc.). 
Generally, no other tasks are built to be loaded into this 
partition. 

The default partition (GEN) is the one you get if you do not 
specify a partition when you build your task. Generally, most 
tasks are built to load into this partition and, therefore, 
compete with each other for this memory space when they are 
requested to run. 

Figure 1-9 shows some tasks and their corresponding 
partitions. Notice that the Task Loader ( . . . LDR) has its own 
partition. This task is the routine that loads all other tasks 
into memory. It is used often, so speed is important. To ensure 
that it always has a spot in memory in which to load, and does not 
have to compete with other tasks for that spot, a special 
partition was created just for it. This guarantees that the 
loader is available to load tasks when needed. 



The size of a partition determines if more than one task can 
be loaded into it. The GEN partition is usually large enough to 
handle many tasks at one time. The number of tasks is dependent 
upon: how much memory is allocated to the partition (partition 
size) , the mix of the number of tasks requested to run in the 
partition and their sizes, and the type of partition. On RSX-11M 
systems there are two types of partitions, user-controlled and 
system-controlled. RSX-11M-PLUS systems only have system- 
controlled partitions. 
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Table 1-2 lists the differences between system- and 
user-controlled partitions. The major difference is in the way 
partitions are subdivided. In a system-controlled partition 
(Figure 1-10) , subdivision is done dynamically to accommodate the 
mix of tasks that have been requested to run in the partition at 
the time. At another time, the number of subpartitions and their 
sizes will be quite different, depending upon the mix of tasks 
again. In a user-controlled partition (Figure 1-11), the 
subpartitions are generated statically at SYSGEN time. There can 
be as many as seven subpartitions. The subpartitions can be 
changed but do not change dynamically at run time to accommodate 
different sized tasks. A task can be loaded into the main 
partition, in which case the subpartition will remain unavailable; 
or a task can be loaded into each of the subpartitions, in which 
case the main partition is unavailable. 
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Figure 1-8 Memory Divided Into Partitions 
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Figure 1-9 Tasks Execute in a Specific Partition 
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Table 1-2 Characteristics of System- 
and User-Controlled Partitions 



Type Controlled 

I System- 
Controlled 



II User- 
Controlled 



Characteristics 

Partition subdivided dynamically. 
Subpartitions vary in size and number 
depending on tasks residing in memory. 

Partition subdivided statically. 
Subpartitions size and number do 

Can have at most seven subpartitions. 
Tasks can reside in each subpartition 
or one task in main partition, but not 
HHHHHHHHHIH1HHIIIHHIIH 
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Figure 1-10 Running Tasks in a System-Controlled Partition 



42 



RSX-11M/M-PLUS SYSTEM OVERVIEW 



MEMORY 



200000 
160000 
140000 
120000 



CTASK 
4K 



BTASK 2K 



JUNUSED"^ 



AT ASK 3K 



EXEC 



1 



SUB3 
4K 

SUB2 
4K 

SUB1 
4K 



UPAR 
12K 



ATASK.TSK 
3K PAR = SUB1 



BTASK.TSK 

2K PAR = SUB2 



CTASK.TSK 

4K PAR = SUB3 



DTASK.TSK 

5K PAR=UPAR 



WHEN UPAR IS SET UP, 3 SUBPARTITIONS OF 4K EACH ARE CREATED. 
THEIR SIZE DOES NOT CHANGE DURING EXECUTION TIME. 

WHEN ATASK, BTASK, CTASK ARE REQUESTED TO RUN THEY MUST 
RUN IN THEIR RESPECTIVE SUBPARTITIONS. 



MEMORY 



1 



200000 



144000 



120000 




EXEC 



UPAR 
12K 



ATASK.TSK 
3K PAR=SUB1 



BTASK.TSK 

2K PAR=SUB2 



CTASK.TSK 

4K PAR=SUB3 



DTASK.TSK 
5K PAR=UPAR 



DTASK HAS BEEN REQUESTED TO RUN 

ATASK, BTASK, CTASK MUST COMPLETE BEFORE DTASK CAN BE 
LOADED INTO THE MAIN PARTITION 

WHILE DTASK IS MEMORY RESIDENT NO OTHER TASK MAY 
OCCUPY THE PARTITION 



Figure 1-11 Running Tasks in a User-Controlled Partition 
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Checkpointing 

A task's ability to remain in memory (discounting the 
condition of completion or aborting) depends upon another concept 
called checkpointing. Checkpointing is the removal of a task from 
its partition (before it has completed execution) and temporarily 
storing its memory image on disk to allow a higher-priority task 
to replace it in the partition. Figure 1-12 shows this procedure. 

1. TASKA has been built for XYZPAR with a priority of 50. A 
request to run TASKA is made. Free space is available in 
the partition, so TASKA is loaded into memory. 

2. TASKC has also been built to run in XYZPAR but has a 
priority of 80. A request to run is made for TASKC. 
There is room in the partition for both tasks, so TASKC is 
loaded . 

3. TASKB, which also has been built to run in the XYZPAR 
partition, has been requested to run. The operating 
system, in finding that there is no room in the partition 
to load the task, checks to see if there is a task of 
lower-priority that it can remove temporarily to 
accommodate TASKB. It determines that TASKA meets those 
requirements, copies TASKA's memory image to a file 
(called the system checkpoint file) on disk, and then 
loads TASKB into the partition. TASKB then competes with 
other active tasks for CPU time. 

4. When space becomes available again, TASKA's saved memory 
image will be loaded back into the partition from the 
checkpoint file, and TASKA will again compete for CPU 
time . 
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Figure 1-12 Checkpointing a Task 
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Shuffling 

Tasks are constantly being loaded, checkpointed and 
completed. When activity in a partition continues like this for a 
period of time, fragmentation of unused space can occur, as shown 
in Figure 1-13. In the partition, APAR, there is 7KW of unused 
space that could be used to load another task. However, because 
it is not contiguous space, it prevents another task from being 
loaded. There is a system routine called the SHUFFLER that 
corrects this fragmentation problem within a system-controlled 
partition. Figure 1-14 shows the function that the SHUFFLER 
performs . 

1. Due to heavy activity on the partition, there are two 
sections of memory available, a IK section and a 3K 
section. Together the space would be large enough to load 
in TASKZ. However, because the space is not in one 
section, TASKZ is blocked from being loaded into memory. 

2. When the shuffler is invoked by the operating system, it 
searches through the partition for free space. When space 
is found, tasks are moved down so that the free space (in 
this case, 4K of free space) is in one area. Then TASKZ 
is no longer blocked and can be loaded into the space. 
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Figure 1-13 Partition Fragmentation 
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Figure 1-14 Partition Shuffling to Obtain Contiguous Memory 
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Allocating CPU Time to a Task 

Once a task has won a spot in memory, it is then able to 
compete for CPU time. A task is given control of the CPU based 
upon its priority and its task state. The CPU is always given to 
the highest-priority, ready-to-run task. The operating system 
schedules the CPU at certain intervals called significant events 
(Table 1-3). Whenever a significant event occurs, the operating 
system reconsiders the state of all active tasks and determines 
which task will be given the CPU. 

Figure 1-15 shows the different states of a task: 

1. KNOWN - A task that has had an entry placed in the System 
Task Directory (STD) . The INSTALL system command is used 
to create a TCB with a task name, priority, partition and 
disk address, and then links the TCB into the STD. 

2. UNKNOWN - A task that has not been installed in the STD. 
There are many more unknown tasks in the system than there 
are known tasks. 

3. ACTIVE - An installed task that has been requested to run 
and is competing for system resources. 

4. DORMANT - An installed task that has not been requested to 
run . 

5. RUNNABLE - An active task that is ready-to-run. 

6. CURRENT - An active task that currently has control of the 
CPU. 

7. BLOCKED - An active task that is kept from running due to 
lack of resources. 



A task changes state when some event applies to it. For 
example, an UNKNOWN task becomes KNOWN when the INSTALL command is 
used to make it known. A KNOWN task becomes ACTIVE when a user 
requests it to be run with the RUN command. An ACTIVE task 
becomes RUNNABLE when all the resources it needs are available. 
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Figure 1-15 Task States 
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Table 1-3 Significant Events that Cause Rescheduling of the CPU 



Events that Cause an ATL 
Scan from Task 
Position Down 



Events that Cause an ATL 
Scan from Top Down 



Task enters wait state 

• Waits for an event flag 

• Significant event 

• "or" of event flags 

• Suspends itself 

• Initiates synchronous I/O 

Task exits/aborts/is aborted 



I/O completion 

Program declares a signif- 
icant event 

Mark time expiration 

Program issues a Send Data 
di recti ve 



RUN command issued 
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Round Robin Scheduling 

When the CPU is idle and not servicing real-time tasks, its 
time can be divided among many tasks giving each a slice of time 
in which to execute. This time-sharing method of scheduling CPU 
time is implemented through the round robin scheduler. It is a 
system generation option that your system manager most generally 
will incorporate into your operating system. It only applies to 
tasks running within a certain range of priorities set up by the 
system manager. Generally, that range is from 1 to 150. 
Real-time tasks are never considered in this scheduling algorithm. 
At a set interval, the round robin scheduler executes in the 
manner shown in Figure 1-16. 

1. Round robin scheduler traverses the ATL looking at tasks 
within a priority. 

2. Within the priority, the scheduler will rotate the 
positions of the tasks, so that the first task in the list 
becomes the last task within the priority, the second task 
then becomes the first task within the priority, etc. 

3. The scheduler then moves on to the next priority and 
rotates the task's position in the same manner. 

The procedure allows for fair distribution of CPU time among 
tasks within the same priority. Without the round robin 
scheduler, the first task in the priority range would always get 
the CPU until it completed or aborted. Then the second task in 
the priority range would get control. 
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Figure 1-16 Round Robin Scheduling 
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Task Addresses 

When a task is developed, source code instructions get 
converted into machine instructions, each with an address. These 
addresses are referred to as virtual addresses; that is, they are 
not the final addresses, or they do not refer to the actual 
physical memory address of where the program will reside. They 
are the addresses used in listings, debugging, etc. A program's 
virtual addresses can range only from - 177777 (0-32KW) . Figure 
1-17 depicts the concept of a task's virtual address space. 
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Figure 1-17 Virtual Address Space 
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Physical Addresses 

The physical address refers to the actual physical memory 
location (Figure 1-18) where a task resides. Physical addresses 
can range from to 2MW. This range is determined by the actual 
amount of memory on your system. 

Because the PDP-11 hardware is a 16-bit architecture, and the 
largest address that can be contained in 16 bits is 65,536 KBytes 
or 32K words, if you wish to access a memory location larger than 
32K words, you need some assistance. This assistance comes 
through adding the KT-11 Memory Management hardware to the system. 
A computer system without this hardware is called an unmapped 
system and will have at most 32K words of memory. A system with 
this hardware is called a mapped system and can have as much as 2 
megawords of memory. 

When a program is loaded into memory, the operating system's 
responsibility is to map the program's virtual address into the 
physical memory location where it will reside. 
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Figure 1-18 Physical Address Space 
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Mapped Systems 

A PDP-11 system that has the KT-11 Memory Management hardware 
attached is called a mapped system. This hardware provides for 
the conversion of a 16-bit virtual address into an 18- or 22-bit 
physical address. This feature allows a task to address a memory 
location greater than 32K words and also to have up to 2 megawords 
of memory on the system. The KT-11 hardware also provides for the 
relocation of tasks in memory because an absolute physical address 
need not be built into the task's image. The operating system in 
conjunction with the KT-11 hardware generates the physical 
address, indicates where to load the task, and then later, if 
necessary, is able to move the task by remapping the task 
addresses (Figure 1-19) . The KT-11 hardware also provides 
security by checking for memory protection violations by a task. 
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Figure 1-19 Mapping a Virtual Address Into a Physical Address 

on a Mapped System 
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Unmapped Systems 

An unmapped system is one without the KT-11 hardware and, 
therefore, can have at most 32K words of memory attached to it. 
Tasks on this system are built to load at an absolute physical 
address (Figure 1-20). Task addresses map directly to their 
physical addresses. To run the task at another physical address, 
the task must be rebuilt using the new desired address. 
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Figure 1-20 Task Built to Execute on an Unmapped System 
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INTRODUCTION 

You interact with your RSX-11M/M-PLUS system through a 
terminal at which you type commands. Most typed commands are 
processed by the Command Line Interpreter (CLI) . 

In this module you study the basics of terminal interaction 
including: 1) the conventions available for terminal use and 
communication with system-supplied CLIs, 2) how to issue system 
commands, and 3) how to get on-line system assistance. 



OBJECTIVES 

1. Log on and off an RSX-11M/M-PLUS system. 

2. Control terminal behavior using control characters. 

3. Use system HELP facilities. 

4. Invoke system operations using MCR or DCL commands. 

5. Switch Command Line Interpreters. 



RESOURCES 



1. RSX-11M/M-PLUS MCR Operations Manual 

2. RSX-11M/M-PLUS Command Language Manual 
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LOGGING ON THE SYSTEM 

Before you can attempt to do any work on the system, you must 
go through a procedure called "logging on" in which you supply 
information when prompted by the operating system. This logging 
on procedure identifies you as a valid user of the system. One of 
the features of an operating system in a multiuser configuration 
is system security. By asking for your name and password and 
comparing this to information stored in the computer by your 
system manager, the operating system can verify whether you are a 
valid user. If you are a valid user, the operating system 
performs some initialization steps, and then grants you access to 
the system resources. 

Before you can attempt to log on to the system, you must ask 
your system manager to set up an account for you in the system 
accounts file. The accounts file contains the following 
information about each authorized system user: 

User Identification Code 

User Name 

User Password 

User Default Command Line Interpreter (CLI) 
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User Identification Code (UIC) 

The User Identification Code is a number assigned to a user 
that uniquely identifies him from other users of the system. 

It has the form [g,m] where: 

g = an octal number from 1-377 
that defines a group of 
users . 

m = an octal number from 1-377 
that uniquely identifies 
a group member. 

A group number is usually assigned to a particular group of 
users such as the payroll department, or the production group. 
Each user in each of these departments would have his own unique 
member number. Suppose the production group was given a group 
number of 305 and you, a member of that group, were given a member 
number of 7. Your UIC would then be [305,7]. Suppose that the 
payroll department was given the group number of 210 and your 
friend, a member of that group, was assigned the member number of 
105. His UIC would then be [210,105]. This number is used to 
keep track of all the privileges and information that you have 
stored in the system. 



Passwords 

When your system manager sets up an account for you, he will 
ask you to supply him with a string of six characters (or less) 
that will constitute your password. This string of characters 
will have to be supplied every time you log into the system. It 
is not echoed (i.e., displayed on the terminal) by the operating 
system when you respond to the password prompt. The operating 
system will check the accounts file to see if the password 
supplied with the UIC or name matches exactly with what is stored 
there. If it does not match exactly, access rights to the system 
resources will not be given to you. Your password can be changed 
by the system manager at any time if you request it. 
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Command Line Interpreter (CLI) 

Once you have successfully logged into the system, a routine 
called a C!ommand L,ine interpreter (CLI) becomes active at your 
terminal. This routine will accept commands made up of keystrokes 
and a line terminator from your terminal, do some interpretation 
on the command line and pass it along to the operating system for 
action. There are two different CLIs available with the operating 
system; computing sites may write their own interpreter. You 
must tell your system manager (when he creates your account) which 
one of these interpreters you wish to have active at your terminal 
when you log in. This will become your default CLI, discussed 
later in this module. 



Notes on Example 2-1 

Example 2-1 shows the log in procedure. The following 
comments are keyed to the example. 

Q User logs in (LOGIN or HELLO) , supplying system with a 
UIC. 

O User supplies his password, but the operating system does 
not echo the characters. 

Q Message indicates what system is being logged into, the 
date, time and terminal number. 

Q System messages displayed at terminal. 

User logs off the system. (LOGOUT or BYE) 

Q User logs on using the slash (/) as a delimiter in the UIC 
to suppress system messages. You will notice that the 
messages shown in note 3 above are not displayed this 
time . 

O User logs on using user name instead of UIC. 

Q User logs on, system prompts for the account or name and 
the password. 
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LOGIH 305? 3 03 
P asswo rd * ■■■■■ 

RSX-liM BL32 12,541 System QUASAR 
06-JAN-82 20} 02 Logged on Terminal TT56. 

Sood Evening 

6-JAN-81 Kogan 

QUASAR will be down FRIDAY (JAN/8/82) from 11130 to 13:00. 
Please let me Know if you have any objections* 

30-DEC-81 Siler 

The DCL theft's now in C2»543 (and installed by STARTUP) is built so 
that it passes unrecognised commands to MCR* If your terminal is set 
to DCL> you can use whichever form of command is easier* MCR or DCL. 

>L0 

Have s Good Evening 

06-JAN-82 20J02 TT56 1 loaded off QUASAR 
>LQGIN 30 5/303 
Password .■^■■B 

RSX-11M BL32 C2.543 System QUASAR 
06-JAN-82 20:02 Logged or. Terminal TT56 * 

Good Evening 

>L0 

Have a Good Evening 

06-JAN-32 20:02 TT56i logged off QUASAR 

>HELL0 ED SERM 

Password 

RSX-11M BL32 C2.543 System QUASAR 
06-JAN-82 20J02 Logged or. Terminal 11561 

Good Evening 

6-JAN-81 Kogan 

QUASAR will be down FRIDAY (JAN/8/82) from 11J30 to 13t00. 
Please let me know if you have any objections* 

30-DEC-81 Siler 

The DCL that's now in C2»54] (end installed by STARTUP) is built so 
that it passes unrecognized commands to MCR* If your terminal is set 
to DCL» you can use whichever form of command is easier* MCR or DCL. 

MCR>BYE 

Have a Good Evening 

06-JAN-82 20J03 TT56! logged off QUASAR 
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O > LOG IN 

Account or name? EBSERV 
Password! MHIHl 

RSX-UM BL32 C2»54D System QUASAR 
06-JAN-82 20:04 Loaded on Terminal TT56 ♦ 

Good Evening 

6-JAN-81 Koaan 

QUASAR will be down FRIDAY (JAN/8/82) from 11S30 to 13t00. 
Please let me know if you have any objections. 

30-DEC-81 Siler 

The DCL that's now in C2»54D (and installed by STARTUP) is built so 
that it passes unrecognized commands to MCR« If your terminal is set 
to DCL> you can use whichever form of command is easier r MCR or DCL. 

>BYE 

Have a Good Evening 

06-JAN-82 20J04 TT56: losSSed off QUASAR 



Example 2-1 Logging on the System (Sheet 2 of 2) 
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Notes on Example 2-2 

Example 2-2 shows a sample terminal session. The following 
comments are keyed to the example. 

O User logs on the system with his last name and password. 
He notes the system name and his terminal number. As this 
is the first time he logged in for the day he reads the 
system messages for important information. 

Q User issues the HELP command to see what information is 
available to help him learn the system. 

Q User decides he needs help using the Editor in DCL so he 
types the HELP EDIT command. 

Q User issues the SHOW USERS command to see who is logged 
on . 

O User checks the time of day by issuing the SHOW DAYTIME 
command . 

O User checks to see if there are any active tasks at his 
terminal. 

O User then logs off the system. 
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>L0GIN ED SERV 
Password! ■■■■ 

RSX-11M BL32 [2*54] System QUASAR 
06-JAN-82 20:04 Loaded on Terminal TT56J 

Good Evening 

6-JAN-81 Kogan 

QUASAR will be down FRIDAY (JAN/8/82) from 11130 to 13i00. 
Please let rue know if you h^ve anu objections* 

30-DEC-81 Siler 

The DCL that's now in [2*543 (end installed by STARTUP) is built so 

that it passes unrecognised commands to MCR ♦ If your terminal is ; set 

to DCL* you car. use whichever form of command is easier* MUK or utL, 

>HELF : ' 

Help is available for m3ny RSX-11M commands and utilities. 

For help in logging in to the system? tyre HELP HELLO or HELP 
LOGIN. You'll need an user-ID and password to log in. 

RSX-11M systems have two major command languages or CLIs. 
These are MCR and DCL. Once you log in? your terminal is set 
to either MCR or DCL. All terminals are set to MCR prior to 
logging in. 

The general form of the HELP command is 

>HELPC/cli3 topic [subtopicCsD 1 

>HELP commandname [ switch 1 

Once you are logged in* you need not include the name of the CLI 
to which your terminal is set. For information on what further help 
is available* type HELPC/MCRJ LIST or HELP/DCL , For a listing 
of help available on other topics? type HELPC/MCR3 MORE or 
HELP/DCL MORE. You need not log in to get help. 

>HELP EDIT 
EDITC/oual if ierU [command line] 
/EDI 

/EDTC/oualif ierCsD 

/KED 

/K52 

/MAKE 

/MUNG 

/SLPII/Gual if ierCsD 

/SOS 

/TECO 

/USINCtusereditor 

The EDIT command invokes an editor. Only EDI* EDT* and SLP are 
supported on RSX-1 1M/M-PLUS systems* KED and K52 are included with 
FMS-11 but are not bundled. Abbreviation. E 

For EDI* and the unsupported editors* the optional command line is a command 
line to the editor which is passed to it without any checking whatsoever. 
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See HELP EDIT EOT and HELP EDIT SLP for info rnist, ion on Qualifiers 
svsileble when invoking EDT» the DEC Standard Editor* and SLP> the 
Source Language Input Program. 

O >SH0U USERS 

HTO: C7>303 

TT6 ♦ C7f3743 

TTli: C7»323 

TT12 ♦ C7»3023 

TT13: C7>423 

TT15t C7,1133 

TT16J C7>1033 

TT20J C7»263 

TT21J E7,3723 

TT23: C301i3333 

TT24t C16»343 

TT27J C7r3613 

TT47J C7»573 

TT52: C304»63 

TT55I C7>323 
^ TT56* C305»3033 
>SHOW DAYTIME 

li:i2:29 21-0CT-81 
O >SHOW TASKS 

MCR. . . 

SH0T56 

O :>L0 

Have 3 Good Morninsf 

21-0CT-81 li:i2 TT56J loaded off QUASAR 
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LOGGING OFF THE SYSTEM 



At the close of your working day or whenever you leave your 
terminal for any length of time, it is suggested that you log off 
the system. Logging off the system ends the terminal session and 
closes off access to your files, system files and privileges. You 
end the session by typing the BYE command, or if you are using DCL 
as your CLI you type LOGOUT. The operating system will type a 
greeting and then give you the date and time that you logged off 
the system. If you are running RSX-11M-PLUS , the system will also 
include accounting information for your terminal session. Example 
2-3 shows the two methods of logging off the system. 
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>L0GIN ED SERV 
Password » ■■■■■ 

RSX-11M BL32 C2»54] System QUASAR 
06-JAN-82 21:07 Logged on Terminal TT56! 

Good Evening 

6-JAN-81 Kog3n 

QUASAR will be down FRIDAY (JAN/8/82) from llt30 to 13:00. 
Please let me know if you have 3ny objections* 

30-DEC-81 Siler 

The DCL that's now in C2i-543 (and installed by STARTUP) is built so 
that it P3ssea unrecognized commands lo MCR. If your terminal is set 
to DCL » you can use whichever form of command is easier* MCR or DCL ♦ 

>L0 

Have a Good Evening 

06-JAN-82 21 J 07 TT56J logged off QUASAR 

> HELLO ED SERv" 
Password • ■■■■ 

RSX-ilM BL32 C2»543 System QUASAR 
06-JAN-82 2i: 08 Logged or. Te rminal TT56J 

Good Evening 

6-JAN-81 Kogan 

QUASAR will be down FRIDAY (JAN/8/82) from 11J30 to 13t00. 
Please let me know if you have any objections. 

30-DEC-81 Siler 

The DCL that's now in C2»543 (and installed by STARTUP) is built so 
that it passes unrecognized commands to rlCR» If your terminal is set 
to DCLi you can use whichever form of command is easier* NCR or DCL« 

>BYE 

Have a Good Evening 

06-JAN-82 2i:08 TT56J logged off QUASAR 



Example 2-3 Logging Off the System 
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USING THE TERMINAL EFFECTIVELY 
Terminals 

Your terminal is your vehicle of communication with the 
operating system. Its capabilities extend beyond the function of 
responding to your keystrokes by sending the applicable signal to 
the operating system. Learning more about this device and its 
capabilities will make your sessions at the terminal more 
productive . 

Terminals are classified as either video (more commonly 
called Cathode Ray Tubes (CRTs) or hard-copy. Both have 
advantages and disadvantages. While CRTs generally transmit and 
receive at a faster rate, they do not provide a permanent record 
of a terminal session. Hard-copy terminals do provide a permanent 
record, but generally transmit and receive at slower rates. They 
also require changing the paper occasionally, so a paper supply 
must be handy. Hard-copy terminals are also useful for those just 
learning the operating system. You may want to start out using a 
hard-copy terminal so that if you work yourself into a corner you 
will have documentation on how you got there. Your course 
administrator will be able to show you where you went wrong. 

Your terminal is made up of two independent devices: 

an input device (the keyboard) and 

an output device (a display - either a screen or a piece 
of paper) 



When you press a key on the keyboard, the terminal sends the 
applicable signal down the terminal line to the operating system. 
The operating system in return lets you know that it received that 
character by sending it back where it is drawn on the screen (or 
typed on the paper). This process is called "echoing." You may 
have noticed during the log in procedure, that when you typed in 
your password, the characters did not echo at your terminal. This 
is to ensure the privacy of your password. 
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The arrangement of the keys on the keyboard may vary from 
terminal to terminal . Figure 2-1 shows an example of two 
keyboards. In addition to the keys found on a standard typewriter 
keyboard, a computer terminal has other keys that perform special 
functions such as starting and stopping output to the terminal, 
erasing typographical errors, retyping a command line, etc. It 
may also have an auxiliary keypad containing the numerical keys 
through 9, a decimal point, an enter key and arrow keys. Some 
system programs (like the editor) use this keypad for performing 
special functions. 

Table 2-1 shows the special keys and their function. Some of 
them require pressing two keys simultaneously to achieve the 
action; these are indicated in the table. When you are 
correcting errors within a command line be sure to use the 
<delete> key instead of the <backspace> key. Although the 
<backspace> key appears to perform correctly, it is not 
interpreted that way by the operating system. Table 2-2 shows how 
the delete key echoes on both a video and a hard-copy terminal. 
In the case of a video terminal, every time the delete key is 
pressed, the operating system (in particular, the terminal driver) 
transmits a command to back up the cursor one position, and then 
transmits a space. In the case of a hard-copy terminal, the 
operating system transmits a backslash and then the last previous 
character is typed. 
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Table 2-1 
(Two 



User Wants To 



Terminate command or 
line of data you have 

Delete last char- 
acter you typed 

Use with another key to 
obtain a control key 
combination 

Retype line you have 
been typing 

Delete entire line 
you have been typing 

Stop output coming 
to a terminal 

Continue output to the 
terminal 

Ask system not to 
print remainder of 
output to 
the terminal 

Interrupt program 
that is executing; 
then type a command 



Special Terminal Keys 
Key Combinations) 

Key to Use* 

<RET> 



<DEL> O 

<CTRL> O 

<CTRL/R> O O 

<CTRL/U> 

<CTRL/S> 

<CTRL/Q> 

<CTRL/0> 

<CTRL/C> O 



Name of Key 
Carriage Return 

Delete 
Control 

Control-R 



Control-U 



(X-ON) 
Control-S 

(X-OFF) 
Control-Q 

Control-0 



Control-C 



Exit from a utility 



<CTRL/Z> 



Control-Z 



*Reversed-out numbers refer to Figure 2-1 



The BACKSPACE key ( on Figure 2-1) is not 
to be used to delete characters in 
RSX-11M/M-PLUS operating systems. 
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Table 2 

If you type: 
SHPW 

<DELXDEL> 



1. 



2 Echoing of Delete 

What appears on 
video screen: 

SHOW 



Key on CRTS/Hardcopy 

What appears on 
hard-copy printout: 

SHPW\WP 
SHPW\WP\OW 



LEARNING ACTIVITIES 

READ the following sections in the 
RSX-11M/M-PLUS Command Language Manual : 

• 3.1, Logging In and Logging Out 

• 3.2, The Keyboard 

• 3.3, The Keypad 

• 3.4, The CTRL key and Control 
Characters 

DO the following at your terminal: 

a. Example 2-1 shows four different 
methods of logging in. Try each 
method using your UIC and last name, 
and decide which method you prefer. 
Ensure that DCL is active at your 
terminal . 

b. Table 2-1 lists special keys that 
help control the action of your 
terminal. Practice using each of the 
keys by issuing the following command 
when you have the system prompt: 

>TYPE LB: [1,2]DCL.HLP 

This file is a text file used by the 
HELP command to display the commands 
for which it has further information. 
Concentrate on how the keys control 
your terminal input and output. 
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CONVERSING WITH THE OPERATING SYSTEM 
Command Line Interpreter (CLI) 

CLIs are the languages used for communication between you and 
the operating system. On RSX-11M/M-PLUS systems, the user has the 
capability of talking to the operating system in more than one 
language. Two such languages are supplied by DIGITAL. They are 
the Digital Command language (DCL) and Monitor Console Routine 
(MCR) . You may talk to the operating system in only one language 
at a time, but can switch easily from one language to another. 
MCR is always present on your system. DCL most likely will be 
present, and your site may include a CLI not provided by DIGITAL. 
You may want to talk to your system manager regarding the 
availablity of CLIs on your system. We will discuss both DCL and 
MCR in this module and will use DCL throughout the course in 
listings and examples. 



CLI Prompts 

When the operating system is ready to accept commands from 
your terminal, it will display its default system prompt, ">" , at 
the left-most position of your display. To determine which CLI is 
active at your terminal and to get the explicit CLI prompt, you 
should type <CTRL/C>. Do this by holding down the control key and 
then typing the letter "C" . The operating system will then 
respond with the appropriate explicit prompt, either the MCR 
prompt : 

MCR> 

or the DCL prompt: 
DCL> 

You can perform this operation whenever you are unsure which CLI 
is active. 
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Default CLI 

The accounts file contains a default CLI for each user which 
is set up by the system manager when your account is created. 
When you log on the system, the accounts file is checked to see 
which CLI is your default CLI. Once the log in procedure is 
complete, the operating system starts your default CLI running at 
your terminal, and displays the implicit operating system prompt 
at your terminal. You are then ready to type system commands in 
the format required by the active CLI. 



Changing from One CLI to Another 

When you wish to change from one CLI to another you must 
issue the appropriate command. To change from DCL to MCR, type 
the following command: 

>SET TERMINAL/MCR 

To change from MCR to DCL, type the following command: 

>SET /DCL=TI: 



USING THE DIGITAL COMMAND LANGUAGE (DCL) 

The Digital Command Language (DCL) is the standard command 
language found on DIGITAL-suppl ied operating systems. Becoming 
familiar with this language will make your migration to other 
operating systems easier. The commands are more English-like, so 
most users prefer to use it. 
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Features of DCL 



• Standard command language used on most DIGITAL operating 
systems. 

• English-like language. 

• Prompts for unsupplied information. 

• Command line continuations: If the command requires more 
characters than will fit on a line, end the first line 
with a hyphen and continue the command on the next line. 

• Commands and keywords can be abbreviated (Four characters 
always sufficient since DCL ensures that first four 
characters are always unique) . 

• Commands can be placed in a file and executed from that 
file. 

• HELP facility available for all DCL commands. 

• Can specify comments within the command line. 



The command line structure is shown below. 
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DCL Command Format 



© 



>P^/Cg^:2^_AFTN,Bj™ <RET> 
oooooooobo o 

>SH0WJ7^/ <RET> 
oooooooo o 

o 

>COPY <RET> 

From? PCLS.DAT<RET> 

To? PGP.DAT<RET> 

Q Operating system prompt - Whenever it is present, commands 
may be entered 

DCL command - Can be abbreviated to at least 4 characters 
Q Command qualifier delimiter - Always a "/" 

Q Command qualifier - A keyword that further defines how to 
interpret the command 

Q Argument delimiter - Always a " : " 

Q Argument value 

O Delimiter (blank or TAB) - Must be included 

O Parameter 

Q List element delimiter 

O Command line terminator 

Q Command line 
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Table 2-3 lists some DCL commands. Example 2-4 shows a 
sample session using these commands. Refer to the RSX-11M/M-PLUS 
Command Language Manual for additional information on each 
command . 



Table 2-3 Partial List of DCL Commands 
User Wants To DCL Command To Use 

Check the time and date SHOW DAYTIME 



Determine who is logged on the 
system 

Check the print or batch job 
status 

Find his session I.D., terminal 
number, accounting information 

Obtain information on terminal 
settings 

Determine what hardware is 
available on the system 

Determine what partitions are 
available on the system 

Protect a file from deletion 

Determine what tasks are installed 

Determine what tasks are active on 
the system 



SHOW USERS 



SHOW QUEUE 



SHOW ACCOUNTING/ 
INFORMATION (M-PLUS only) 



SHOW TERMINAL 

SHOW DEVICES 

SHOW PARTITIONS 

SET PROTECTION 

SHOW TASKS/INSTALLED 

SHOW TASKS/ACTIVE 
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> SHOW DAYTIME 
10J50J56 22-OCT-81 
>SHOW USERS 
HTi: C7»223 
TTAt C7»3743 
TT11J C7»323 
TT12: C7r3023 
TT13: C7>423 
TT14 I C7,1103 
TT15J C7»1133 
TT16J C301»3033 
TT17: C7»3663 
TT21 ♦ C7»3723 
TT22J I7tll61 
TT23: C301»3333 
TT24J C52»303 
TT25: C301»443 
TT27: C7>3413 
TT5i: C100r243 
TT53J C7»3373 
TT55J C2»2013 
TT56: C305t3033 
>SHOU QUEUE 
** PRINT QUEUES ** 
PRINT *> LPO 

C7»U33 DCLRES ENTRYM33 

> 1 DROJ C7f 1133 DCLRES. MAP? 41 
LPO => LPO 
>SHOW TERMINAL 
TT56! C305»3033 

CLI « DCL 

LINES 66* 

LOWER NO PR IV 



ACTIVE ON LPO 



C305»3033 

BUF = 132. HFILL ■ 
TERM - LA120 OWNER - none 
NOHOLD NOSLAVE NOESC NOCRT 



ECHO 



NOVFILL NOHHT 



NOFDX WRAP 



NORPA 



SPEED=<9600J9600) 
BRO NOABAUD 
FORM NOREMOTE 
NOEBC TYPEAHEAD 



>SHOU dev mm: 

MMO: TT23: - Private Mounted Loaded 
MM1 ♦ Loaded 



Example 2-4 DCL Commands (Sheet 1 of 6) 
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>SH0W DEVICES 

Offline Loaded 
C7»223 - Loaaed in Loaded 
Offline Loaded 
Offline Loaded 
Loaded 

Loaded Type=RP05 
Public Mounted Loaded Type=RP06 
Public Mounted Loaded Type=RP06 
Loaded 
Loaded 
Loaded 
Loaded 
Loaded 
Loaded 

Loaded Type=RL01 
Loaded Type=RL02 
Loaded Type=RL01 

TT51 t - Private Mounted Loaded Type=RK04 
Loaded Type=RK06 
Loaded Type=RK07 
Public Mounted Loaded Type=RP07 
Loaded Type-RM03 
EMO: Type=RS04 
EMO! Type=RS04 
Loaded 
Loaded 
Loaded 
Loaded 

Public Mounted Loaded Type=MLll Size=409<&. blks 
TT23 J - Private Mounted Loaded 
Loaded 
Loaded 

Public Mounted Loaded 
Loaded 
Loaded 
Loaded 
Loaded 
Loaded 
Loaded 



lpo: 

DROJ 

dro: 
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>SHOW PARTITIONS 

CEXPAR 114734 00115000 00003000 
TTPAR 114670 00120000 00040000 
EXC0M1 114624 00160000 00014700 
EXC0H2 114560 00174700 00006200 
SYSPAR 114514 00203100 00012000 
TKNPAR 114450 00215100 00010000 
DRVPAR 114404 00225100 00030600 
114340 00225100 00002100 
114240 00227200 00001200 
114140 00230400 00003100 
114040 00233500 00003000 
113740 00236500 00001000 
113640 00237600 00001100 
113540 00240700 00001400 
113440 00242300 00002500 
113340 00245000 00002600 
113240 00247600 00001300 
113104 00251100 00004300 
112450 00255400 00000300 
LDRPAR 112404 00255700 00002500 
BASIC2 112340 00260400 00040000 
FCSRES 112274 00320400 00040000 
TSTPAR 112230 00360400 00100000 
GEN 112164 00460400 03317400 
045174 00460400 00006300 
061140 00466700 00014200 
046100 00507200 00017000 
046160 00526500 00044000 
046034 00572500 00044000 
100544 00643600 00013600 
075740 00666000 00023300 
045430 00723600 00044000 
046370 00767600 00024000 
046270 01013600 00032200 
044770 01046000 00014100 
047560 01062100 00027000 
060534 01111100 00044000 
062220 01232000 00025600 
070214 01257600 00020300 
070750 01362200 00132000 
045240 01516200 00132300 
071730 01650500 00107400 
075014 01760100 00055700 
074554 02112100 00060000 
072450 02172100 00132000 
071040 02324400 00055700 
100610 02402300 00132300 
100500 02707700 00175700 
NT.PCL 062634 03671600 00003500 
NT.NSP 053244 03675300 00016000 
NT.AUX 062264 03713300 00001100 
POOL.. 061074 03714400 00061700 
045034 03776300 00001500 
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MAIN 


COM 




MAIN 


TASK 




MAIN 


COM 




MAIN 


COM 




MAIN 


TASK- 




MAIN 


TASK 




MAIN 


SYS 




SUB 


DRIVER - 


db: 


SUB 


DRIVER - 


dk: 


SUB 


DRIVER - 


DM 5 


SUB 


DRIVER - 


dr: 


SUB 


DRIVER - 


em: 


SUB 


DRIVER - 


dt: 


SUB 


DRIVER ~ 


dxj 


SUB 


DRIVER - 


dl : 


SUB 


DRIVER - 


D D ♦ 


SUB 


DRIVER - 


lp: 


SUB 


DRIVER - 


mm: 


SUB 


DRIVER - 


co: 


MAIN 


TASK 




MAIN 


COM 




MAIN 


COM 




MAIN 


TASK 




MAIN 


SYS 




SUB 


(PMT. . ♦ ) 




SUB 


(EVP. ♦ . ) 




SUB 


(COT. . . ) 




SUB 


(WKFFCP) 




SUB 


(SYOFCP) 




SUB 


( MTAACP > 




SUB 


(RMHACP) 




SUB 


(DB1FCP) 




SUB 


(DB2FCP) 




SUB 


(QMG. ♦ ♦ ) 




SUB 


(LPO ) 




SUB 


(RMDEMO) 




SUB 


(F11ACP) 




SUB 


(NETACP) 




SUB 


(SH0T56) 




SUB 


( . , . EDT ) 




SUB 


( ♦ . .PIP) 




SUB 


(HT1 ) 




SUB 


(EX1 ) 




SUB 


( . . .AT. ) 




SUB 


(EDTT16) 




SUB 


(EX2 ) 




SUB 


(MAL.O ) 




SUB 


( . . ♦ TKB ) 




SUB 


DYNAMIC 




SUB 


DYNAMIC 




SUB 


DYNAMIC 




SUB 


DYNAMIC 




SUB 


DRIVER - 


HT! 



(Sheet 3 of 
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>SH0W TASKS INSTALLED 



1 fl c« 

LDN . . « 


i O 1 o 

12 . It 


i ri D o a c* 
L 1< h r A h 


248 ♦ 


TKTN 


04 . 7 


TP Lr* VI © A O 

TKNPAR 


248 ♦ 


d u fi r u n 


ill Ar 


f* C VI 

GE.N 


o o *c 
225 . 


MTAAPD 


AA 1 "I 


UtN 


OA A 


r 11 nob 


l ia a 1 o 

VUU1 «t 


ncu 
utn 


OA A 


K1CT AfP 


UflO OO 


fSFN 


OA A 

A. \/v « 


r up 

CVr » » • 


uoi oo 
W X . vv 


ucn 


X 7 7 . 


MPD 


O AO 


alarnK 


1 AO 
1 O V » 


♦ t ♦ nui\ 




P. FN 


1 AO . 


<3UflTS A 

anu i jo 


1 1 

1.x 




1 AO 


... Mnn 
• ♦ * nuu 


OSOT 


C5FN 
ucn 


1 AO . 

X O V . 


» » ♦ DCL 


00 


GEN 


160 . 


« 4 ♦ HEL 


01.0 


GEN 


1 50 . 


♦ » ♦ LH « 


A A A 
1 . UU 




1 so 


. . . tut 

♦ ♦ • 1/ V 1 


*T . V 


RFN 
ucn 


ISO. 




4 . OO 


ucn 


1 so . 

X w v ♦ 


NVP ♦ t » 


UOI . 00 


GEN 


150. 


. > ♦ BYE 


04,0 


GEN 


150 . 


F 1 1 ACP 


H0401 


GEN 


149. 


wi\r rur 


M040 1 
nvivi 




1 49 . 

1*17 » 


c y o F P P 


MO40 1 
nvtvi 


RFN 
ucn 


1 49 . 

X T 7 . 


UOlrLr 


MO AO 1 

nvtu 1 


ucn 


1 49 . 

X *T 7 ♦ 


tirof pp 


M040 1 




149. 

1*17 1 


PMT . . . 
r n 1 * ♦ ♦ 


1 . SO 


RFN 


1 48 . 
X T o ♦ 


rppi nn 

cr\f\ luu 


U 1 . 04 

V X . V *t 


ucn 


1 4ft . 
i to t 


PflT ... 


01.01 

V X ♦ V X 


GEN 


1 4S . 

X T w ♦ 


... nun 


o "«; . o s 


RFN 

UC11 


140. 


TUT 
♦ ♦ « 1 IT 1 


OO AO 


r;c(J 
ucn 


1 40 


... urn 
* ♦ ♦ ur u 


U04 1 O 


ucn 


140. 

X *T V . 


PMD • ♦ ♦ 


07 » 2 


GEN 


130 . 


SHF . ♦ ♦ 


5 ♦ 08 


SYSPAR 


105 ♦ 


« » ♦ INS 


06 


GEN 


100 . 


» « ♦ SEN 


22 JUL 


GEN 


100. 


i\i innwr 


U02 . 00 


GEN 


100 ♦ 


MAL$*$ 


1 1 RX 


GEN 


100 ♦ 


PMR*$* 


V01 ♦ 05 


GEN 


100 . 


QMG » ♦ ♦ 


1 . 8 


GEN 


70 . 


LPO 


1 . 9 


GEN 


70 ♦ 


PRT . ♦ ♦ 


1 ♦ 2 


GEN 


70 . 


. . .BRU 


1.03 


GEN 


70. 


. ♦ ♦ KKK 




GEN 


70. 


. . .TEC 


V36 


GEN 


65. 


♦ . .EDI 


Mil .04 


GEN 


65. 


. . . SOS 


07.00 


GEN 


65. 


♦ ♦ . EDT 


02.00 


GEN 


65. 


. . .MAI 


01SEP 


GEN 


65. 


RMT. ♦ . 


V02.01 


GEN 


65. 


♦ ♦ ♦ RVT 


X02. 19 


GEN 


65. 


EDTT16 


02,00 


GEN 


65. 


... AT . 


02 


GEN 


64. 


NTL . . . 


V02.00 


GEN 


60. 


NTINIT 


V02.00 


GEN 


55. 


. . . BRO 


V04 


GEN 


50. 


LPINIT 


01.03 


GEN 


50. 



00002500 LB0:-01240437 FIXED 
00010000 LB0:-01242244 
00027000 LBOJ-01262570 
00013600 EM0*. -00000325 
00005500 LB0:-01251052 
00025600 SY0I-01266761 
00013100 SYOt-01266561 
00012000 LBOt-01244424 
00020300 LBOi-01244760 
00020300 LB0:-01244760 
00037600 LB0:-00117642 
00035600 SYOJ-01132456 
00037600 LBOt-01250645 
00005100 LBOJ-01251064 
00052200 SYOt-01007774 
00052200 SY0. , -01007774 
00012700 SYOJ-01265031 
00012500 SY0. -01264767 
00044000 LB0J-01247227 
00044000 LB0. -01262523 
00044000 EMO:-00000260 
00044000 SY0J-01262313 
00024000 SYOI-01262404 
00006300 LB0:-01246016 
00040000 LBOJ-01251006 
00017000 LB0J-01250736 
00014600 LB0:-01245770 
00034600 LB0J-01246445 
00005700 LBOJ-01246615 
00017600 LBOt-01250210 
00012000 LB0J-01250203 
00034400 LB0J-01243744 
00104400 LB0:-00662645 
00023300 SYOJ-01265073 
00132300 SYOt-00663342 
00034300 SY0:-00660507 
00032200 LBOt-01252004 
00014100 LBOt-01252136 
00001100 LBOi-01251443 
00173500 LBOi-01256414 
00163400 DK2:-00010412 
00177100 EMOJ-00001215 
00123600 EM0:-00001371 
00073300 EM05-00001547 
00132000 LBOt-01254476 
00123700 SY0:~00555723 
00027300 SY0:-01266505 
00032500 SYOi-00663556 
00132000 LB01-01254476 
00060000 LB0:-01246107 
00036500 SYOJ-01265603 
00005000 SYOi" -01265347 
00031000 LB0:-01250552 
00016200 LB0:-01250260 



Example 2-4 DCL Commands (Sheet 4 of 6) 
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>SH0W TASKS 


/ACTIVE 


MCR ♦ f ♦ 




SH0T56 




>SHOW TASKS 


/ACTIVE /ALL 


LDR < < ♦ 




RMDEMO 




NETACP 




EVP ♦ . , 




MCR. . . 




SH0T56 




F11ACP 




DB1FCP 




PMT. ♦ . 




COT . ♦ . 




QMG . » . 




LPO 




. . . EDT 




♦ . .AT. 





Example 2-4 DCL Commands (Sheet 5 of 6) 
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>SHOW TASKS ACTIVE 

MCR ♦ ♦ ♦ 

SH0T56 

>SHOW TASKS ACTIVE ALL 

LDR... 

RMDEMO 

MTAACP 

NETACP 

EVP.,. 

MCR. ♦ . 

SH0T56 

F11ACP 

WKFFCP 

SYOFCP 

DB1FCP 

DB2FCP 

PMT . ♦ . 

COT... 

RMHACP 

QMG . . . 

LPO 

...TEC 

. . .EDT 

EDTT16 

... AT . 

...PIP 

. . ♦ TKB 

EX1 

EX2 

EXST 

HT1 

> 



Example 2-4 DCL Commands (Sheet 6 of 6) 
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THE HELP COMMAND 



One of the most useful features of this operating system is 
the help that it provides on-line for the system commands. It is 
not necessary to search through manuals to find the correct format 
of a command or the qualifier that you need. By typing the HELP 
command in response to the system prompt, you will get a list of 
items for which the system has more information. HELP is the only 
command that you can type before logging onto the system. 

Examples of the HELP command are shown below. 



HELP Command Format 



>HELP<RET> 




HELLO<RET> 



>HELP 




>HELP SET TERMINAL<RET> 
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Notes on Example 2-5 

The following comments are keyed to the example. 

O In response to the HELP command, the operating system 
displays the list of active CLI commands at your terminal 
for which it has information. 

To obtain information on any of those listed, type HELP 
and the command you wish the information for. Notice that 
the text gives you the syntax of the command and an 
explanation of what the command will do. 

Q To get help on a command of another CLI, use the /"CLI" 
qualifier shown here. Hello is an MCR command and is not 
listed in the HELP text shown in note 1 above. 

Q In this example, you will notice that the text includes 
the command qualifiers that can be used with the command. 

Q This and the following two examples show how to obtain 
further information on a command. Notice that the SET 
command has many attributes which it can change. To get 
further information, for example, on the TERMINAL 
attribute, you would concatenate this attribute to your 
original HELP command. 

Q This example shows how the procedure described above is 
accomplished . 

Q The HELP command is further qualified to obtain more 
information on setting the terminal, in particular the 
commonly used attributes. 
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:>HELP 



Help is available for the following DCL commands* 



DEBUG 
EDIT 



CONVERT 



STOP 



LOGOUT 

PURGE 

RUN 



ABORT 
BASIC 



INITIALIZE 



ALLOCATE 

BROADCAST 

COPY 

DELETE 

FIX 

INSTALL 

MACRO 

RELEASE 

SET 

TYPE 



REMOVE 
SHOW 



FORTRAN 
LIBRARY 
MCR 



APPEND 
CANCEL 
CREATE 



DIFFERENCES 



UNFIX 



RENAME 

SORT 

UNLOCK 



HELP 
LINK 
MOUNT 



ASSIGN 
COBOL 

DEALLOCATE 
DIRECTORY 



BACKUP 

CONTINUE 

DEASSIGN 

DISMOUNT 

HOLD 

LOGIN 

PRINT 

REQUEST 

START 



For information on a command* type HELP conimandname ♦ Additional help on 
a particular qualifier is often available by typing 



You can also get help on DCL commands by typing a ? in response to a prompt* 

For information on utilities* system tasks* and other system inf ormstion* 
type HELP MORE » For the short form*, of some commands* type HELP BRIEF ♦ 
For help on logging in type HELP LOGIN ♦ 

>HELP LOGIN 
LOGIN userid 

LOGIN allows you access to the system if you have a valid acount. 

'userid' it* either your last name* or a UIC with the two numbers separated 

by either a comma (*) or & slash (/)♦ The sctuare brackets <C3) are optional 

for this command. After entering your userid* you will be prompted 

for your password* The password will not echo on the your 

terminal* You can enter the password on the same line as the LOGIN 

command by preceding it with a slash* but your password will be 

echoed. 

If the userid and password are valid* you will be logged on the system* 
The login message file* LB* CI * 23LQGIN.TXT* will be printed on your 
terminal* unless you entered 'userid' as a UIC separated by a slash* in 
which case only the most recent massages will be printed* If you have 
a login command file (L0GIN.CMD) in your directory* it will then be 
executed* 

LOGIN 3nd HELLO sre identical* but LOGIN does not work on systems 
without DCL. 



HELP commsndnsme uuslifier. 



Example 2-5 HELP Command (Sheet 1 of 3) 
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>HELP/MCR HELLO 

To log onto this system* you must know sn account oi- lost name end 
the appropriate password* Log on by saying HELLO. The HELLO command 
has the following General forms! 

HELLO 

You will be prompted for your name or account and password. 

HELLO name/password 

Where name is your last name* and password is your account password. 
If the slash and password are left off (they are optional)* you will 
be prompted for your password. 

HELLO Csirp nnem3/p3SSwo rd 
HELLO Cgrp/memH/passwo rd 

Where grp and mem are the group and member numbers of your account. 
The sauare brackets and password are optional. If a comma separates 
grp and mem* system messages (the LB J C 1 * 23L0GIN . TXT file) will be dis- 
played on your terminal immediately after you have logged in. If a slash 
is the separator* the L0GIN.TXT file will be displayed on your 
terminal until 3 % is found in column i of the file. 

■- H E L P COPY 

COPYC/oualif ierCsDD infileCs] outfile 

Qual if ie rs 

/BLOCKSIZEJr. 
/C NO 3 CONTIGUOUS 
/OWN 

/REPLACE 

/IiATEJdd-mmm-yy 

/SINCE, dd-mmni-yy 

/SPAN-BLOCKS 

/THROUGHLJdd-mnim-yy 

/SINCE ♦ dd- mm m-yy /THROUGH * dd-mmm-yy 

/TODAY 

/EXCLUDE J f i lespec 

The COPY command copies one or more input files to an output file. 
COPY does not 3lter the organization of the file. See HELP CONVERT 
for information on changing the organization of the file. 

Abbreviation. C 

=-HELP SET 
SET thing 

The SET command can be u&ed to set something. The following things 
can be set with this command: 

CDAY3TIME DEBUG DEFAULT DEVICE GROUPFLAGS 

LIBRARY CN03PARTITI0N PRIORITY PROTECTION QUEUE 

SYSTEM TERMINAL 



Example 2-5 HELP Command (Sheet 2 of 3) 
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HELP SET TERMINAL 

SET TERMINALC » ttnn J 3/3tt ributeCs] 

The SET TERMINAL command sets various attributes of your terminal. A 
privileged user can set attributes of yna other terminal. 

The RSX-llli/M-PLUS Command Language Reference Manual divides the attri- 
butes into the 3 categories of common user terminal setup > and task 
setup . 

See HELP SET TERMINAL COMMON-USE 

HELP SET TERMINAL TERMINAL-SETUP 
HELP SET TERMINAL TASK-SETUP 

HELP SET TERMINAL QUALIFIERS 
HELP SET TERMINAL csual if iername 



>HELP SET TERMINAL COMMON-USE 
SET TERMINALC :ttr.r.::/sttributeCsD 

The following Qualifiers set terminal characteristics that are regular 
needed by the average terminal user. For more information on a parti- 
cular characteristic* type HELP SET TERMINAL characteristic. 

/CNO JBROADCAST 
/DCL 

/CN01H0LH-SCREEN 

/LOWERCASE 

/MCR 

/CNOD PRIVILEGED 
/CN03SERIAL 
/SPEED? (if r ) 
/UPPERCASE 
/WIDTH J n 



Example 2-5 HELP Command (Sheet 3 of 3) 
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LEARNING ACTIVITIES 

READ the following sections in the 
RSX-11M/M-PLUS Command Language Manual ; 

• 1.1, RSX-11M/M-PLUS and DCL: Basic 
Concepts 

• 1.2, The DCL Command Line 

• 1.3, Functional Grouping of DCL 
Commands 

• 3.5, HELP 

DO the following at your terminal: 

a. Issue the HELP command to see the 
list of topics for which there is 
information 

b. Using the SET command, change your 
current CLI to MCR 

c. Issue the HELP command to see what 
MCR topics are available 

d. Using the MCR SET command, change 
your current CLI back to DCL 
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FILE SPECIFICATIONS 
Files 

Information stored on the system is contained in an entity 
called a file. A file is the smallest unit of storage maintained 
by the operating system, A user may store files on many different 
devices. To retrieve the files, the operating system must have a 
means of keeping track of the name of the file, to whom it belongs 
and where that file is located on a device. There is a special 
set of software that maintains the file structure called FILES-11. 
It is the software's responsibility to keep track of files by 
maintaining directories for each system user. Many of the 
operating system commands perform functions on a file. To 
identify the correct file, a standard format for specifying a file 
is required. 
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File Specification Command Format 

The following is an example of the complete file 
specification format. Whenever a file specification is required 
in a command, this is the format in which it is to be supplied. 
It is not always necessary to supply information in each field. 
If a field is not supplied, the system will make some assumptions 
about the entry for that field. The second example below shows a 
"minimum required" file specification. In some instances this 
specification can be shortened to just the file name. 

The notes below describe each field of the file 
specification. We will discuss each one in detail. Study the 
notes and fix in your mind each of the fields of the 
specification . 

A complete file specification 

DB: [305,303] EXAMPIJ.MAC ; 3 
o e o o o oo 



A minimum required file specification 

EXAMPLE.MAC 
© o e 



o 


Physical , 


logical or pseudo device name 


e 


User File 


Directory (UFD) 


o 


File name 


(0 to 9 characters) 


o 


File name 


del imiter 


e 


File type 


(0 to 3 characters) 


o 


File type 


delimiter 


e 


File version number 
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Devices 

Physical Device Names 

The first field in the file specification specifies the 
device where the file is stored. 

A computer system consists of various hardware components 
including : 

Line printers 
Disk drives 
Floppy disk drives 
- Magnetic tape drives 

Analog to digital converters 
Paper tape reader/punch 



To distinguish a line printer from a floppy disk drive or 
even from another line printer, the operating system must have a 
unique name with which it can associate the piece of hardware. As 
the user, you want to be able to say "I want the file that is 
stored on the floppy disk drive rather than the one on the 
magnetic tape drive." And also, "I want this file printed on the 
second line printer on the system, not the first." To do this, you 
need a format for specifying devices. When you refer to a 
specific device on the system, you can use the device's physical 
device name. 



The physical device name has the format: 



DDnn : 



Device Name Meaning Example 

Element 



DD 


Two alpha characters 
depicting a device. 


TT 


nn : 


Two numeric characters 
depicting the device unit 
number. The first unit 
number is 0. Colon always 
requi red . 


31: 
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Figure 2-2 illustrates physical device names. Each device 
has a name made up of a two character mnemonic representing the 
type of device it is, and a two digit number representing which 
unit of that device type it is. Table 2-4 lists the devices and 
their physical device name. In Figure 2-2, there is a device with 
the name DB1 : . In Table 2-4, DB is the physical device name for 
RP04, RP05, and RP06 disk drives. 



PHYSICAL DEVICE NAMES 




DBO: DB1: 



Figure 2-2 Physical Device Names 
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Table 2-4 RSX-11M/M-PLUS Peripheral Devices 



Peripheral Devices 

Analog-to-Digi tal Converter (AD01-D) 

Laboratory Peripheral System (AR11) 

Card Reader (CR11) 

Cassette (TA11) 

DECtape (TC11) 

DECtape II (TU58) 

Di sks 

RP04/05/06 disk packs 
(RH11/RH70/RP04/RP05/RP06) 

RF disks (RF11) 

RK05 cartridge disks (RK11) 

RK06/07 cartridge disks (RK611) 

RL01 cartridge disks (RL11) 

RM02/03 disks (RH11/RM02, RH70/RM03) 

RP02/03 disks (RP11) 

RS03/04 disks (RH11/RH70/RS03/RS04) 

RX01 floppy disk (RX11) 

RX02 floppy disk (RX211) 

Graphics Display Processor and Scope 
(VT11/VS60) 

Industrial Control System Local 
and Remote (ICS/ICR-11) 

Industrial Control Subsystem (DS11/DRS11) 



Device-Uni t 
ADnn : 
AFnn : 
ARnn : 
CRnn : 
CTnn : 
DTnn : 
DDnn : 



DBNN: 
DFnn : 
DKnn : 
DMnn : 
DLnn : 
DRnn : 
DPnn : 
DSnn : 
DXnn : 
DYnn : 

GRnn : 

ICnn : 
ISnn : 
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Table 2-4 RSX-11M/M-PLUS Peripheral Devices (Cont) 
Peripheral Devices Device-Unit 
Laboratory Peripheral Accelerator (LPA11-K) LAnn: 



Laboratory Peripheral System (LPS11) 

Line Printer (LA11/LS11/LP11/LV11) 

Magtapes 

TU45/TU16/TE16/TU77 
(RH11/RH70/TM02/TM03) 

TS03/TU10/TE10 (TM11/TMA11/TMB11) 

TS04 (TS11) 

Paper Tape Punch (PC 11) 

Paper Tape Reader (PC11/PR11) 

Terminal (DL11/DH11/DJ11/DZ 11 ) 

Parallel Interprocessor Link (PCL-11B) 
[RSX-11M-PLUS systems] 

TXnn :/RXnn : 

Parallel Line Interface (DA11-B) 

Asynchronous Line Interface (DL11-E) 

Interprocessor Link (DMC) 

Synchronous Line Interface (DP11) 

Universal Digital Controller (UDC11) 



LSnn : 
LPnn : 



MMnn : 
MTnn : 
MSnn : 
PPnn : 
PRnn : 
TTnn : 



XBnn: 
XLnn : 
XMnn: 
XPnn : 
XQnn : 
XWnn: 
XUnn: 
UDnn : 
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Logical Device Names 

You may also specify a logical device name in the first field 
of the file specification, A logical device name is a generic 
name assigned to a physical device by the user. Logical device 
names provide device independence for programs and system 
operations because the association between the logical device and 
a specific physical device can easily be changed to another 
physical device. A logical device can be used in the device 
specification, but must first be associated with the actual 
physical device chosen by the user. The format of the logical 
device is the same as the physical device. However, the first two 
digit mnemonic is of your choosing and has the meaning that you 
associate with it. 



DDnn : 



Logical Device Meaning Example 

Name Element 



DD 


Two alpha characters 
depicting a device. 


LZ 


nn : 


Two numeric characters 
depicting a unit num- 
ber. Colon always 
requi red . 


01: 



Notes on Figure 2-3 

Figure 2-3 shows how logical device names can be used. The 
following comments are keyed to the example. 

Q The association between the physical device DB0: and the 
logical device LZ1: is made using the ASSIGN command. 

Q The Directory command lists the files in the user's work 
area. Specifying the logical device name of LZ1: gets a 
directory from the physical device DB0: 

Q The logical device LZ1: is reassigned to the physical 
device DB1: 

O Performing the same directory command as before, you now 
get a directory from the physical device DB1: 
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O > ASSIGN DBO: LZ1: 




N v ' 

PHYSICAL DEVICE 



© > DIR LZ1: [305,303] 

DIRECTORY DBO: [305,303] 
16-JULY-81 10:30 

A. FTN;1 2. 10-JULY-81 14:41 

B. FTN;1 2. 9-JULY-81 8:33 
PROG.FTN;1 4. 9-JULY-81 10:05 

TOTAL OF 8./10. BLOCKS IN 3. FILES 

> 

TK-7681 

Figure 2-3 Logical Device Assignments (Sheet 1 of 2) 
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©> ASSIGN DB1: LZ1: 




O > DIR LZ1: [305,303] 

DIRECTORY DB1 : [305,303] 
16-JULY-81 10:32 



VIP.FTN;2 4. 15-JULY-81 15:12 
VIP.FTN;3 5. 15-JULY-81 16:42 
VIP.TSK;3 6. 16-JULY-81 17:01 

TOTAL OF 15./16. BLOCKS IN 3. FILES 

> 



Figure 2-3 Logical Device Assignments (Sheet 2 of 2) 
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Pseudo Device Names 



You may also specify a pseudo device name in the first field 
of the file specification. Pseudo device names are a small set of 
logical device names that have special meaning to the operating 
system. They refer to devices that most users and tasks often 
use. Table 2-5 lists the set of pseudo device names. Of 
particular interest to the general user are the devices TI: and 
SY:. Wherever your terminal number is part of the required syntax 
you may substitute the pseudo device of TI:. The operating system 
then makes the association of TI: to the actual physical device 
name for you. Anyone may use TI: to represent the physical 
device name of their terminal; the operating system makes the 
association to the actual physical device. SY: is used in the 
same manner. It represents the device on which your UFD is 
located . 



Not everyone using the system has their UFD on the same 
device. When the System Manager sets up your account, he 
establishes a UFD on a particular device. This becomes your 
default device. When you specify SY: in a command or file 
specification, the operating system makes the association * 
actual physical device name. 



to the 



Table 2-5 Pseudo Device Names 



Pseudo 
Device 
Name 

CL: 



CO: 
LB: 

SP: 

SY: 

TI: 
WK: 



System-Wide 
or User- 
Specific? 

System 



System 
System 

System 

User 

User 
System 



Description 

Console listing device, usually 
line printer 

Console output device, usually TT0 

System default device, "library 
device" containing system files 

System spooling device, usually 
line printer 

User default device, assigned 
individually by system manager 

User terminal 

Workfile device, usually fastest 
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Figure 2-4 shows the correlation between the pseudo devices 

(TI: and SY:) and the physical device for two users. For the 

user on terminal number 5, TI: equates to TT5: and SY: equates 

to DB0 : . For the second user, TI: equates to TT31: and SY: 
equates to DB1 : . 




PSEUDO PHYSICAL 
DEVICE DEVICE 



TI: 


TT5: 


SY: 


DBO: 



LOCAL ASSIGNMENTS 



PDP-11/70 




PSEUDO PHYSICAL 
DEVICE DEVICE 



TI: 


TT31: 


SY: 


DB1: 




DBO: 



DB1: 



LPO: 



PSEUDO 


PHYSICAL 


DEVICE 


DEVICE 


CO: 


TTO: 


CL: 


LPO: 


LB: 


DBO: 



SYSTEM ASSIGNMENTS 



Figure 2-4 Pseudo Device Names 
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User File Directories (UFDs) 

When your account is created for you, a file called a User 
File Directory (UFD) is also created. This file has the same 
number as your UIC and will contain the names and locations of all 
the files stored on the disk structure that belong to you. At 
least one UFD exists for every user with a system account, and a 
user may have a UFD on many different devices. 



File Names 

The name given to a file generally reflects what the file is 
for. It can be from to 9 alphanumeric characters and is 
separated (delimited) from the file type by a period. File names 
are given to files either by you when you create them with the 
editor, or copy them, or by programs that generate output files. 



File Types 

The file type is a to 3 alphanumeric character extension of 
the file name to further qualify the type of file. It is 
separated from the version number by a " ;". There are standard 
file types and each utility recognizes its own particular file 
type (Figure 2-5) . Whenever you see a file with a .MAC file type 
you may assume that the contents of that file contain MACRO-11 
program source statements. Likewise, if you see a file with a 
.FTN file type, you can assume that the contents of the file are 
FORTRAN program source statements. Table 2-6 shows the standard 
file extensions and the type of file they represent. 



Versions 

Each file has a version number that distinguishes it from 
other versions of the same file. Version numbers are octal and 
range from 1 to 77777. 
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A.FTN 



WRITE (5,999) ZERO 
999 FORMAT (1X, 15) 
CALL SUB 




TK-7675 



Figure 2-5 Standard File Types 
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Table 2-6 Standard File Types 

Type File Contents 

BAS A BASIC language source program 

B2S A BASIC-PLUS-2 source program 

CBL A COBOL language source program 

CMD MCR or task commands (an indirect command file) 

COR A SLP correction file 

DAT Data (as opposed to a program) 

DIR A directory (for example, a User File Directory) 

FTN A FORTRAN language source program 

LST A listing 

MAC A MACRO-11 source program 

MAP A Task Builder memory allocation map 

MLB A macro library 

OBJ An object program (output from the MACRO-11 Assembler 
or a compiler) 

ODL A Task Builder overlay description 

OLB An object module library 

SML The system macro library 

STB A symbol table 

SYS A bootable system image 

TMP A temporary file 

TSK A task image 

ULB A universal library file 
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It is not necessary at all times to give complete file 
information when specifying a file. The system will make some 
assumptions about each field if you do not supply the information. 
We call this "taking the defaults." Table 2-7 lists the defaults 
the operating system takes for each field of the file 
specification. Taking the defaults and allowing the system to 
fill in the information saves you typing, time and possible 
typographical errors. 



Table 2-7 



File Specification Defaults 



File Specification 
Element 



Default 



Device 



SY: 



UFD 



User's default UFD 



File Name 



No default, must be supplied 



File Type 



Depends on command or utility 



Version 



On input file - latest version 
On output file - latest version 
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Figure 2-6 shows all the valid file specifications for the 
latest version of the file A.FTN. The amount of information 
necessary depends upon the situation in which the specification is 
being used. If [200,200] is your UFD, then you would not need to 
specify the UFD. If you want the latest version of the file, you 
would not have to specify the version. And if you were supplying 
the file to the FORTRAN compiler, you would not have to specify 
the file type. The FORTRAN compiler searches for a file type of 
FTN by default. You will become aware of how much information you 
must supply through your use of the system. 



SY: 

DBO: [200,200] 




DBO: [200,200] A.FTN;2 
SY: [200,200] A.FTN;2 
[200,200] A.FTN;2 
A.FTN;2 
A.FTN 
A. 

TK-7672 



Figure 2-6 Valid File Specifications for Latest 

A.FTN Version 
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Wildcards in the File Specification 
Wildcards 

Often, we wish to perform the same operations on many files 
with the same name or the same file type; for instance, copying 
all our macro source files from one UFD to another, or perhaps, 
deleting all our listing files. To type each of these files in 
the command line would be time-consuming and we would probably 
spend more time than desired correcting our typing errors. There 
is a feature of the operating system that allows us to substitute 
a special character to represent the concept of "all" in the file 
specification. Two special characters called wildcard characters 
can be used to do this. 

The character "*" is the wildcard character representing 
"all" in a variable number of character positions. The character 
"%" is the wildcard character representing "all" in a single 
character position. For example, we can use these characters when 
we want to represent all : 



• 


UFDs 


• 


Groups 


• 


Group members 


• 


File names 


• 


File types 


• 


File versions 



110 



GETTING STARTED ON THE SYSTEM 



Notes on Example 2-6 

The following comments keyed to Example 2-6 show the use of 
the wildcard characters and the results. 

O A listing of the directory file for the UFD [305,303]. 

O A listing of the directory file for the UFD [305,304]. 

Q The (*) is used in the file type field to represent all 
file types. The system interprets this as the latest 
version of all files with the name PROG and any file type, 
and displays all the files that meet this criteria. 

Q Using the (*) in the file name field allows us to obtain 
all our macro source files without having to type all the 
file names and extensions. 

Q The (%) is used to indicate all possibilities in one 
character position. In this example we are asking the 
system to provide all listing files with a four character 
file name beginning with PR. 

O In this example, we are looking for six character task 
file names beginning with PR. 

You may also use the (*) in the UFD. In this example we 
are looking for a listing of the directories of all the 
members of group 305. Member numbers 301,303, and 304 are 
listed for us. 

Q In this example we are asking for all the task image files 
found in the directories of all the members of group 305. 

Q Here we are asking for all files that have a file name 

with an "0" as the second character of the name. The file 

name will have at least two characters in it and may have 
as many as nine. 

Table 2-8 shows the rules for using wildcard characters. 
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Directory DK1 5 [305*3033 
21-0CT-81 09M0 



LOGIN ♦CMH i 1 


1 . 




04 


-AUG 


-81 


08.43 


urn 

vIP . TSK r 1 


4 . 


C 


14 


-AUG 


-81 


10 ♦ 48 


PAYROLL ♦ CBL » 1 


2 . 




08 


-JAN 


-81 


15.31 


INFO ♦ TXT } 1 


60 » 




07 


-JUL 


-80 


12.47 


LOGOUT . CMD » 5 


1 . 




28 


-MAY' 


-80 


08 .49 


PROG.FTNJ 1 


6 ♦ 




14 


-AUG 


-81 


08.35 


PR0G.0BJJ 1 


. 




14 


-AUG 


-81 


08.36 


PROG.LSTJ 1 


♦ 




14 


-AUG 


-81 


08.36 


PR0G.0BJJ2 


5 . 




14 


-AUG 


-81 


08136 


PR0G.LSTJ2 


1 1 . 




14 


-AUG 


-81 


08136 


PR0G.FTNJ2 


6 . 




14 


-AUG 


-81 


08:36 


PROG .FTNJ3 


6. 




14 


-AUG 


-81 


08:37 


PROG. TSK » 1 


6, 


C 


14 


-AUG 


-81 


08:37 


MAC 10. mac; 5 


3. 




04 


-AUG 


-81 


09:14 


MACIO . OBJ i 5 


1 . 




14 


-AUG 


-81 


10M6 


MACIO.LSTf 1 


5. 




14 


-AUG 


-81 


10M6 


DIRECTORY ♦ LST i 1 


3. 




18 


-AUG 


-81 


16:28 


XYZ.MACi 1 


3. 




19 


-AUG 


-81 


09: 43 


XYZ.TSK* 1 


4. 


c 


19 


-AUG 


-81 


09M3 


VIP.0BJJ3 


1. 




19 


-AUG 


-81 


09: 46 


VIP.MAC55 


3. 




19 


-AUG 


-81 


09M6 


VIP.OBJf 4 


1. 




19 


-AUG 


-81 


09: 47 


VIP.0BJJ5 


1 . 




19 


-AUG 


-81 


09: 47 


VIP.LSTJ5 


5. 




19 


-AUG 


-81 


09M7 


MACIO. MAC? 7 


3. 




19 


-AUG 


-81 


09J48 


MACIO. MAC 5 6 


3. 




19 


-AUG 


-81 


09M8 


MACIO. MAC i 10 


3. 




19 


-AUG- 


-81 


09M9 


PRIMES . TSK i 1 


46. 


c 


19 


-AUG 


-81 


13:57 



Totsl of 193. /199. blocks in 28. files 



©Directory DK1 : C305 , 304 3 
21-0CT-81 09M1 



LOGIN, CMDJ1 


1 . 




04 


-AUG- 


•81 


08M3 


LOGOUT. CMDf 5 


1. 




28 


-MAY- 


■80 


08 5 49 


STARTUP . CMD i 57 


14. 




06 


-JUL- 


81 


10J53 


PRIMES » MAC » 43 


8. 




15 


-JAN- 


■81 


16t 15 


ADVENTURE . TSK i 1 


151 . 


C 


05 


-AUG- 


•81 


16:29 


CLAMBAKE . TXT J 1 


3. 




05 


-AUG- 


•81 


16: 18 


NOTICE ♦ TXT i 1 


14. 




16- 


-MAR- 


81 


10:34 


PRIMES . OBJ i 1 


2. 




14 


-AUG- 


81 


li:09 


PRIMES. LSTfl 


13. 




14 


-AUG- 


81 


li:09 


PRIMES. TSKJ1 


46. 


C 


14 


-AUG- 


•81 


li:09 


PRIMES.MAPJ1 


3. 




14- 


-AUG- 


■81 


11 :09 


A . MAC t 2 


3. 




18 


-AUG- 


81 


16:30 


VIP.TSKJl 


4. 


C 


19- 


-AUG- 


81 


13:58 


PROG. TSK J 1 


6. 


C 


18 


-AUG- 


81 


16*.31 



Total of 269./273. blocks in 14. files 
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>t'IR PROG ♦ * 



Directory DK1 5 [305*3033 
21-0CT-81 09541 

PR06.FTNJ3 6. 14-AU6-81 08537 

PROG.OBJ52 5. 14-AUG-81 08536 

PR0G.LSTJ2 11. 14-AUG-81 08536 

PR0G.TSKJ1 6. C 14-AUG-81 08537 

Total of 28. /28. blocks in 4. files 



O > DIR *>HAC 



Directory DK1 5 C305> 303D 
21-0CT-81 09540 

MACIO.MACilO 3. 19-AUG-81 09549 

XYZ.MACfl 3. 19-AUG-81 09543 

VIP .MAC 15 3. 19-AUG-81 09546 

Total of 9./13. blocks in 3. files 



>DIR PR%%.LST 

Directory DK1 * E305» 303D 
21-0CT-81 09542 

PR0G.LSTJ2 11* 14-AU6-81 08536 

Total of 11. /II. blocks in 1. file 

>DIR PR%%%Z.TSK 

Directory DK1 5 C305»3033 
21-0CT-81 09542 

PRIMES. TSK? 1 46. C 19-AUG-81 13557 

Total of 46. /46. blocks in 1. file 

Example 2-6 Using Wildcards in a File Specification (Sheet 2 of 4) 
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O >DIR E305r*: 



Directory DK1 1 C305f 3033 
21-0CT-81 09M1 



LOGIN. CMD i 1 


1 . 




04-AUG-81 


08143 


VIP.TSK* 1 


4. 


C 


14-AUG-81 


10MS 


PAYROLL. CBL?1 


2. 




08-JAN-81 


15*.31 


INFO.TXTf 1 


60. 




07-JUL-80 


12M7 


LOGOUT. CMD>5 


1 . 




28-MAY-80 


08J49 


PROG.FTN* 1 


6. 




14-AUG-81 


08! 35 


PROG. OBJ* 1 


* 




14-AUG-81 


08:36 


PROG.LSTJ 1 


0. 




14-AUG-81 


08:36 


PROG. OB J» 2 


5. 




14-AUG-81 


08:36 


PRQG.LSTr 2 


1 1 . 




14-AUG-81 


08.36 


PR0G«FTNi 2 


6 . 




14-AUG-81 


08:36 


PROG . FTN r 3 


6 . 




14-AUG-81 


08:37 


nnnr TOW* 4 


6 . 


C 


14-AUG-81 


08 : 37 


MACI0.MACi5 


3. 




04-AUG-81 


09:14 


MACIO.OBJJ 5 


1. 




14-AUG-81 


10M6 


MACI0.LSTJ1 


5. 




14-AUG-81 


10M6 


DIRECTORY. LSTil 


3. 




18-AUG-81 


16:28 


XYZ.MACil 


3. 




19-AUG-81 


09M3 


XY2.TSKJ 1 


4. 


c 


19-AUG-81 


09M3 


VIP.OBJf 3 


1. 




19-AUG-81 


09M6 


VIP.MAC5 5 


3. 




19-AUG-81 


09M6 


VIP.OBJf 4 


1. 




19-AUG-81 


09: 47 


VIP.0BJJ5 


1. 




19-AUG-81 


09: 47 


VIP.LSTJ5 


5. 




19-AUG-81 


09M7 


MACIO.MACJ 7 


3. 




19-AU6-81 


09M8 


MACI0.MAC*6 


3. 




19-AUG-81 


09M8 


MACIO.MACflO 


3, 




19-AUG-81 


09M9 


PRIMES. TSKU 


46. 


c 


19-AUG-81 


13:57 



Total of 193. /199. blocks in 28. files 



Directory DK1 1 C305> 304] 
21-0CT-81 09M1 



LOGIN . CMD i 1 


1. 




04- 


-AUG- 


-81 


08 


143 


LOGOUT. CMDJ 5 


1. 




28- 


-MAY- 


-80 


08 


149 


STARTUP. CMIU57 


14. 




06- 


-JUL- 


-81 


10 


:53 


PRIMES . MAC? 43 


8. 




15- 


-JAN- 


-81 


16 


:i5 


ADVENTURE. TSKJ1 


151. 


C 


05- 


-AUG- 


-81 


16 


:29 


CLAMBAKE. TXT* 1 


3. 




05- 


-AUG- 


-81 


16 


:i8 


NOTICE. TXTJ1 


14. 




16- 


-MAR- 


-81 


10 


:34 


PRIMES. OBJ* 1 


2. 




14- 


-AUG- 


-81 


11 


:o9 


PRIMES. LSTfl 


13. 




14- 


-AU6- 


-81 


11 


:o9 


PRIMES. TSKU 


46. 


C 


14- 


-AUG- 


-81 


11 


:o9 


PRIMES .MAP J 1 


3. 




14- 


-AUG- 


-81 


11 


:o9 


A .MAC t2 


3. 




18- 


-AUG- 


-81 


16 


J30 


VIP.TSKil 


4. 


C 


19- 


-AUG- 


-81 


13 


158 


PROG, TSKU 


6. 


C 


18- 


-AUG- 


-81 


16 


:3i 



Total of 269./273. blocks in 14. files 



Directory DKi:C305»301D 
21-0CT-81 09M1 

INF0.TXTJ1 60. 17-AUG-81 14*.54 

Total of 60. /60. blocks in 1. file 

Grand total of S22./532. blocks in 43. files in 3. directories 
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>DIR C305»*3*.TSK 



Directory DK1 : C305» 3033 
21-0CT-81 09M4 



VIP.TSKJ 1 
PROG.TSKJ 1 
XYZ.TSK?! 



PRIMES. TSKfl 



4. 
6* 
4* 
46. 



C 
C 
C 
C 



14-AUG-81 
14-AUG-81 
19-AUG-81 
19-AUG-81 



10M8 
08J37 
09M3 
13J57 



Total of 60. /60 



blocks in 4. files 



Directory DK1 ♦ C305f 3043 
21-0CT-81 09M4 



ADVENTURE .TSKfl 
PRIMES. TSKfl 
VIP.TSKJ 1 
PROG.TSKJ 1 



46. 

4. 

6. 



151. 



C 05-AUG-81 

C 14-AUG-81 

C 19-AUG-81 

C 18-AUG-81 



16*29 
11J09 
13:58 
16:31 



Total of 207. /207. blocks in 4. files 

Grand total of 267«/267. blocks in 8. files in 2. directories 

>DIR 7.0*.* 

Directory DK1 { C305 f 3033 
21-0CT-81 09M5 

LOGIN. CMDil 1. 04-AUG-81 08M3 

LOGOUT . CMDr 5 1. 28-MAY-80 08M9 

Total of 2./2. blocks in 2. files 
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Table 2-8 Allowed Use of Wildcard Characters 



File 

Specification 
Field 

Device name 
UFD 



File name 



File type 
Version number 



Is (*) allowed? 

Yes, to replace an 
entire group and/or 
member field 

On an input file, 
allowed to replace 
all or part of the 
file name 

On an output file, 
allowed to replace 
only the entire file 
name 

Same as file name 

Yes, to replace an 
entire version 
number 



Is (%) allowed? 

^^^^^^^^^^ 



On an input file, 
allowed to replace 
all or part of the 
file name 

Not allowed on an 
output file 



Same as file name 



LEARNING ACTIVITY 

1. READ the following sections in the 
RSX-11M/M-PLUS Command Language Manual ; 

• 4.1, Files on RSX-11M/M-PLUS Systems 

• 5.1, Devices on RSX-11M/M-PLUS 
Systems 

• 5.1.2, Physical Devices, Pseudo 
Devices, LUNS and Logical Names 
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USING THE MONITOR CONSOLE ROUTINE (MCR) 
MCR 

MCR is the original command line interpreter of the 
RSX-11M/M-PLUS operating systems. It is the root for all DCL 
commands, and contains all the functionality of DCL and some 
privileged functions that cannot be accomplished in DCL. The 
format of the MCR command line is shown below. A partial list of 
MCR commands is shown in Table 2-9. Appendix B of the 
RSX-11M/M-PLUS Command Language Manual contains associated MCR 
commands for each DCL command. 
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MCR Command Format 

© 

/ A N 

>^ DKa/TERM^TT^ 
o o o o o o o 

o 

/ \ 

oooooo o © 



O Operating system prompt 

Q MCR command 

O Command delimiter (blank or tab) 

Q Parameter 

O Keyword 

Q Keyword value 

Q Output file specification 

Q Delimiter 

Input file specification 

© Switch 

O Command line terminator 

© Command line 
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• n ,i 5 f of MCR Commands 
Table 2-9 Partial List of 

MCR Command 

User Wants To tim[e] 
Check the time and day DEV[IC E]TT: 

Check the print queue or batch QU E[UE]/LI 
nob status 

Get infor mation on terminal settings 
Determine what hardware is available 
on the system 

Determine what partitions are available ^ 
on the system pip 

Pro tect a file from being deleted 

Determine which tasks are installed 

on the system 

• « which tasks are active on 
Determine whicn 

, np whic h tasks are available 
Determine wnicn 
at user's terminal 



RUN 
MOU 
LUN 



Mount a volume in 
FILES-11 structure 

■np the logical units associated 
Determine tne J-uy 
with a task brq 

Send a message to another user 

Allocate a device for private use 

Abort a running task 

r .1 a time-based initiation request 
Cancel a time u 
from the clock queue 



ALL 
ABO 

CAN 
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Notes on Example 2-7 

The following comments are keyed to the example. 

Q Active command issued that shows there are three tasks 
active at your terminal. 

Q ABORT command issued. 

Q ACTIVE command issued again to see what tasks were active. 

Q ABORT command issued to abort the task named TT56. 

Q SET command issued to make DCL active at the terminal. 

O SHOW USERS command issued improperly. An error message is 
returned to indicate that the command was not recognized 
by DCL. 

Q SHOW USERS command properly issued. 

Q Active Task List (ATL) command issued to display all the 
tasks that are active on this system at the time. See the 
RSX-11M/M-PLUS MCR Operations Manual for description of 
the printout. 

Q Installed Task List Short Form (TAS) command to display 
all tasks that are installed in the System Task Directory. 

© Partition (PAR) command issued to display the partition 
configuration of memory. See the RSX-11M/M-PLUS MCR 
Operations Manual for a description of the printout. 

Q Device (DEV) command issued to display information about 
the magnetic tape units on the system. This display shows 
that there are two units. The first unit is privately 
allocated to TT20:; the second is available for use. 

© Queue (QUE) command issued to list information about the 
print queue. There are no jobs waiting to be printed. 

O Device (DEV) command issued again, only this time to 
display information about all the devices (both physical 
and pseudo) that are part of the system. 
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O MCR> ACT 
MCR. . . 
♦ ♦ • MCR 



>ABO TT56 

ABO — Task marked for abort 
O >SET /DCL=Ti: 
>SOW USERS 

DCL — Illegal command 

v. 

> 

>SET /DCL=Ti: 

O DCL>5HQW USERS 
HT1J [7,223 
TT6 » [7,3743 
TT11J [7,323 
TT12J [7,3023 
TT13: [7,423 
TT14I [7,1103 
TT15* [7,1133 
TT16: [301,3033 
TT17J [7,3663 
TT2i: [7,3723 
TT22* [7,1163 
TT23* [301,3333 
TT24J C55,303 
TT25t [301,443 
TT27J [7,3613 
TT51J [100,243 
TT53J C7,3373 
TT55J [2,2013 
TT56J [305,3033 
TT57J [7,1133 
>L0 

Have a Good Morning 

22-0CT-81 li:03 TT565 loSsied off QUASAR 



Example 2-7 MCR Command Samples (Sheet 1 of 6) 



TT56 

>AB0 
>ACT 



MCR « ♦ . 
. ♦ .MCR 
TT56 
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O >ATL 

ldr ♦ ♦ « 112050 ldrpar 112404 00255700-00260400 pri - 248. dpr i - 248. 
status: -chk fxd stp -pmd prv nsd 

ti - coo: ioc - 0. bio - 0. eflg - 000001 000000 ps - 170000 

PC - 120370 REGS 0-6 120212 013541 177777 107646 074700 107614 120166 

rmdemo 053120 gen 047560 01062100-01111100 pri - 225. dpri - 225. 
status: -chk wfr -pmd prv mcr 

ti - tto: ioc - 1. bio - 0. eflg - 000020 040000 ps - 170010 

PC - 136254 REGS 0-6 000000 136333 132110 000000 136375 000243 121164 

mtaacp 051274 gen 100544 00643600-00657400 pri - 200. dpri - 200. 
status: stp acp -pmd prv nsd 

ti - coo: ioc - 0. bio - 0. eflg - 000006 040002 ps - 170001 

PC - 120650 REGS 0-6 051306 077304 051306 077244 000000 120656 120352 
NETACP 047214 GEN 062220 01232000-01257600 PRI - 200. DPRI - 200. 
STATUS: STP ACP -PMD PRV NSD 

TI - COO? IOC - 0. BIO - 0. EFLG - 000000 000000 PS - 170000 
PC - 120452 REGS 0-6 000004 000010 104170 000000 065504 063404 120242 
EVP... 060754 GEN 061140 00466700-00503100 PRI - 199. DPRI - 199. 
STATUS: STP -PMD PRV 

TI - COO: IOC - 0. BIO - 0. EFLG - 000001 000000 PS - 170000 
PC - 120512 REGS 0-6 127536 000000 003424 130556 000011 125674 120272 
MCR... 110160 SYSPAR 114514 00203100-00215100 PRI - 160. DPRI - 160. 

status: stp -pmd PRV MCR CLI nsd cal 

TI - TT56: IOC - 0. BIO - 0. EFLG - 000001 040000 PS - 170000 

PC - 122436 REGS 0-6 000000 120476 122032 120432 010766 044146 120366 

...mcr 107614 gen 074700 01155100-01175400 pri - 160. dpri - 160. 
status: ckd -pmd prv mcr nsd 

ti - tt56: ioc - 0. bio - 0. eflg - 000001 040000 ps - 170000 

PC - 121454 REGS 0-6 120424 121276 121706 000000 121302 000000 000742 
CA.T24 101444 GEN 077424 00657400-00664500 PRI - 150. DPRI - 150. 
STATUS: WFR -PMD REM PRV 

TI - TT24: IOC - 0. BIO - 0, EFLG - 000000 000000 PS - 170000 

PC - 123266 REGS 0-6 124114 000037 122470 000001 135600 121257 121172 

f11acp 111550 gen 060534 01111100-01155100 pri - 149. dpri - 149. 
status: stp acp -pmd prv nsd cal 

ti - coo: ioc - 0. bio - 0. eflg - 000002 000001 ps - 170000 

PC - 135350 REGS 0-6 155272 000000 000020 102373 060644 076224 120310 
WKFFCP 111320 GEN 046160 00526500-00572500 PRI - 149. DPRI - 149. 
STATUS: -CHK STP ACP -PMD PRV NSD 

TI - COO? IOC - 0. BIO - 0. EFLG - 000002 000001 PS - 170000 
PC - 135350 REGS 0-6 000400 155254 000000 000034 047344 100500 120310 
SYOFCP 047434 GEN 046034 00572500-00636500 PRI - 149. DPRI - 149. 
STATUS: -CHK STP ACP -PMD PRV NSD 

TI - COO: IOC - 0. BIO - 0. EFLG - 000002 000001 PS - 170000 

PC - 135350 REGS 0-6 000000 074130 000032 151460 046640 074070 120310 

db1fcp 046470 gen 045430 00723600-00767600 pri - 149. dpri - 149. 
status: -chk stp acp -pmd prv nsd 

ti - coo: ioc - 0. bio - 0. eflg - 000002 000001 ps - 170000 

PC - 135350 REGS 0-6 034024 076444 000032 150570 051114 076404 120310 

db2fcp 050460 gen 046370 00767600-01013600 pri - 149. dpri - 149. 
status: -chk acp -pmd prv nsd 
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>TAS 



LDR ♦ . ♦ 


12.19 


LDRPAR 


248 . 


00002500. LBOi 


-01 9404" ) !7 FTypH 


TKTN 




l t\ n r rl r\ 


£. *t O » 


ftftft 1 ftftft a. 


1 U ft 1 


-01 9A07A4 


PMTICMn 


U 1 . ft 


utn 


it. e. J . 


ftftftD7AAA 
OOU2 /OOO 


1 bft 1 
LdO < 


— ft 1 Oil "i 7ft 

V 1 Z O sJ / V 


n 1 nnlir 


rtftl 1 


ncu 

UCn 


900 


ftftfti A A A 
OOO looUU 


CM A 

tno 


— ftftftftftTOtr 


F11MSG 


V0012 


r*cn 
BEN 


AAA 

200 . 


00005500 


LB0 


A4 OCT4 ACO 

-01251052 


klTTAPD 


V02 . 00 


btN 


1 AA 

200 . 


A A A O C£ Z A A 

00025600 


OVA 

SY0 


-0 1266/61 


cue* 
tvr ♦ ♦ ♦ 


1 1 A 4 A A 

V01 ♦ oo 


UtN 


4 OO 


AAA4 T 4 AA 

00013100 


OVA 

SY0 


— A 4 OiZC/ 4 

—O 1 iOOJ6 1 


MCR ♦ « ♦ 


O A O 

2 . 02 


S YSFAK 


4 L A 

160 . 


00012000 


LBO 


-01244424 


♦ . ♦ MCR 


1.1 


GEN 


160. 


00020300 


LB0 


-01244760 


Mm i 

♦ ♦ ♦ nuu 


2303 


btN 


4 £ A 

160 * 


AAAT7ZAA 

00037600 


LBO 


AA4 4 7iAO 

-001 1 /642 


♦ ♦ ♦ DLL 


A A 


utN 


4 L A 
160 . 


00035600 


SY0 i 


A4 4 TOACZ 

-0 1 1 32456 


» » . HEL 


01.0 


GEN 


ISO . 


00037600 


LBO) 


-01250645 


♦ ♦ ♦ CA « 


4 . 00 


GEN 


150 . 


00005100 


LBO J 


-01251064 


. . .CVT 


4.02 


GEN 


150. 


00052200 


SYO! 


-01007774 


. . .DLG 


4.02 


GEN 


150. 


00052200 


SY0 i 


-01007774 


NVP ♦ » » 


V01 ♦ 00 


GEN 


150 . 


00012700 


SYO < 


-01265031 


Tt V C 

» . . BYE 


04 . 


UtN 


1 50 . 


AAA4 OE"AA 

00012^00 


SYO ! 


-01264767 


r 11 nLr 


MA A A 4 


UtN 


4 A O 

1 4r . 


AAAAAAAA 
O0044000 


1 O A i 

LBO i 


A4 OA700"7 

-01247227 


wi\r r ur 


MA A A 1 


utn 


1 AO 

X *T 7 . 


ftftftAAftftft 


1 Kft « 

LdO 


— ft 1 tii^n 
O 1 262<j23 




MftAft 1 


ucn 


1 AO 
x *t T « 


ftftftAAftftft 


CM ft 

tno 


— ftftft ft ftOAft 




MA Aft 1 


ucn 


1 AO 
X f 7 ♦ 


ftftftAAftftft 


CVft < 
O T o 


— ft 1 Oil! 1 "7 
O 1 262o 1 tJ 


U D «• r Lf r 


HO Aft 1 

n v " v jl 


ucn 


It / » 


ftftfto Aftftft 


CYft 
SI u 


-ft ^ O AO AftA 


DMT . . 


ftl "i"? 


ucn 


1 AR 


ftftftftXTtftft 

00006000 


1 Ctft < 

LdO a 


— ft 1 OAAftl A 


cppi nn 


II 4 A A 
VltUt 


new 
utn 


1 AO 
1 *tO . 


AftftAftftftA 
OOOhOOvO 


1 C A 

LdO 


— ft 1 o<=:i ftAi 


COT ♦ « ♦ 


01 . 01 

V X » V X 


wen 


1 4 e i . 

X "t »J ♦ 


ftftft 1 7ftftft 


1 Ftft 4 


-01 < 5 e ;07'XA 
V Jl i J v / oo 


» ♦ ♦ unu 


CO » it 3 


ucn 


1 Aft 


ftftft 1 A Aftft 


LDU 


— ft 1 OA c i7 7ft 
VlcnJ/ /v 


„ „ .TNT 




GEN 


1 40 . 

X *t V ♦ 


ftftOIA Aftft 


1 Pi ft 1 


-01 04A44 c i 


. » . UFD 


V0412 


GEN 


140. 


OOOftSTftft 


1 Rft ' 


-01 04AA1 "i 


PMTl 

rPil' ♦ ♦ ♦ 


ft 7 o 
O / ♦ 2 


utn 


1 TEA 
1 OU . 


AAA4 

OOOl / 600 


1 DA < 

LdO 1 


— ft 1 OC!A04 ft 
012 J0210 


ouc 
bnr » ♦ ♦ 


C! AO 

D . Oo 


CVGDAD 

a Y brftK 


4 ACT 


AAA4 OAAA 
00012000 


1 DA 

LoO 


A4 OCAOATf 

-012D0203 


T MC 
♦ « « INS 


ft A 

06 


UtN 


1 Aft 

1 ou . 


ftftfti A AAA 

0003 i » i t00 


1 tf ft < 
LdO i 


— A 4 OA77AA 

-012 1 »3/*J i t 


ecu 
♦ ♦ ♦ btN 


OO II II 

22 JUL 


utN 


4 AA 
100 . 


AA4AA>IAA 
00104400 


1 DAI 

LdO < 


AAiiOiAC 

-0066264%j 


RMHACr 


■ 1 A O A A 

002 . 00 


GEN 


1 00 ♦ 


AAAOITfAA 

00023300 


C V A < 

oYO J 


-01265073 


MAI AAA 


4 4 O V 

1 IKa 


utN 


4 AA 
100 . 


AA4 117Art 

00132300 


OVA* 

SYO 


_AAi i*T*7AO 

-00663342 


r nK»»» 


i i a i Ac: 
V0 1 . OO 


flC M 

UtN 


4 AA 
1 OO . 


AAATf A Tf A A 

00034300 


O V A < 

oYO 


— A A i ZftCA"J 

-O0660 JO / 


nun 


4 O 
1 . O 


a c ki 
utN 


"7 A 
/0 . 


AAATOOAA 

00032200 


1 DA 4 

LdO 


— A 4 OCTOAAA 

-01 2 j200 4 


Lr o 


1 o 

X ♦ 7 


Utn 


/ O » 


AAA4 A4AA 
OOOl *t 1 OO 


1 D A < 

LdO 


— ft 4 Till TtA 


rKI t i t 


4 O 

1.2 


UtN 


7 A 
/O ♦ 


AAAA 4 4 A A 
0000 1100 


1 DA 

LdO 


— ft 1 0<51 AAT! 

-O12ol443 


DDI 1 


4 A "7 
1 . 03 


UtN 


7 ft 


AA4 7 "7 C. A A 

001 /3 jUU 


1 DA < 

LdO 


— ft 1 ir,iil A 
-012v>6414 


♦ » • M\l\ 




UtN 


7ft 


ftft 1 jiTCArtA 
OO 1 6o*tOO 




— ftftft 1 ft A 1 o 


TCP 


VOO 


UtN 


zs 
OJl 


00177100 


EMOi 


— ft ft ft ft 1 01 tr 


. . .EDI 


Mil. 04 


GEN 


65. 


00123600 


EM0 


-00001371 


. . . SOS 


07.00 


GEN 


65. 


00073300 


emo: 


-00001547 


. ♦ . EDT 


02.00 


GEN 


65. 


00132000 


LB0J 


-01254476 


♦ . . MAI 


01SEP 


GEN 


65. 


00123700 


SY05 


-00555723 


RMT. . . 


V02.01 


GEN 


65. 


00027300 


SY0J 


-01266505 


♦ ♦ ♦ RVT 


X02.19 


GEN 


65. 


00032500 


SY0J 


-00663556 


EDTT16 


02.00 


GEN 


65. 


00132000 


LBO 


-01254476 


EDTT22 


02.00 


GEN 


65, 


00132000 


LB05 


-01254476 


♦ . .AT. 


02 


GEN 


64. 


00060000 


LB0J 


-01246107 


NTL. ♦ . 


V02.00 


GEN 


60. 


00036500 


SY0J 


-01265603 


NTINIT 


V02.00 


GEN 


55. 


00005000 


SY0< 


-01265347 


. . . BRO 


V04 


GEN 


50. 


00031000 


LBO \ 


-01250552 


LPINIT 


01.03 


GEN 


50. 


00016200 


LBO 


-01250260 
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* • . uut 


1 m 


otw 


•5 A 


AAAOB"DAA 


1 Er A 

Lev 




oof 


1.10 


r* c ki 
□ EN 


50 . 


00025200 


LBO 


► -01252041 


DTD 

♦ . • P I F 


LI 4 T A TT 
M1343 


r* r ij 
GEN 


50 . 


A A 4 T07AA 

001 .52300 


EMO 


AAAAAjI at 

-00000443 


MAP 


Ml OA A 

n i tuu 


ULN 


cr A 


A A 1 1 A 1 A A 


CM A 


_AAAAA C ". I= ;7 


♦ * ♦ TKB 


M40 ♦ 00 


C kl 

GEN 


50 » 


J\ y\ A a *"1 a A A 

001 02400 


EMO 


-0000231 


♦ ♦ » LBR 


06 . 00 


/n r- kl 
GEN 


DO . 


00154400 


EMO 


i -00001 103 


LKr ♦ ♦ ♦ 


VOl 




K A 

DO . 


AAi < Z/AA 

001 1 6600 


EnO 


-OOOOl 1 65 


. » . MUN 


V36 


GEN 


50 . 


00177100 


EMO 


-00001215 


♦ . . CMP 


V0109 


6EN 


50 • 


00151300 


EM0< 


-00001341 


. * .RNO 


M0101 


GEN 


50 ♦ 


00061600 


EMO 


I -00001443 


. . .SLP 


11 .03 


GEN 


50. 


00027400 


EMOJ 


-00001515 


. ♦ .SRD 


4. IF 


GEN 


50. 


00043500 


EMO 


► -00001750 


. ♦ .BCK 


0002CH 


GEN 


50. 


00065600 


SYO 


-00065660 


. . .DOC 


06DEC 


GEN 


50 ♦ 


00061600 


SYO 


-00063566 


. . . DTR 


V01 . 10 


GEN 


50. 


00175000 


SYO 


-00063652 


MAL. . . 


300CT 


GEN 


50. 


00057700 


SYO 


'-00553461 


NICE. . 


V02.00 


GEN 


50. 


00026600 


SYO 


-01266362 


. ♦ .NCP 


V01.00 


GEN 


50. 


00037100 


SYO 


-01266061 


FAL. . . 


V02.01 


GEN 


50. 


00075200 


SYO 


-01267327 


. . ♦ NFT 


V02.00 


GEN 


50. 


00035400 


SYO 


-01267224 


♦CMTS. 


V02.00 


GEN 


50. 


00002000 


SYO 


-01235557 


TCL ♦ . . 


V02.00 


GEN 


50 . 


00002400 


SYO 


-01265126 


. . . NTD 


V01 .00 


GEN 


50. 


00021200 


SYOJ 


-01265005 


NTD. . . 


V01.00 


GEN 


50. 


00011700 


SYO. 


-01266544 


. ♦ . RMT 


V02.00 


GEN 


50. 


00002100 


SYO 


-01235551 


. . . FLX 


M15 


GEN 


50. 


00037700 


LBO 


-01253617 


♦ . .LOA 


03.3 


GEN 


50. 


00033100 


LBO 


-01244354 


. ♦ . UNL 


3.0 


GEN 


50. 


00025100 


LBO 


-01245146 


♦ , , F4P 


V3.0 


GEN 


50. 


00122600 


SYO 


-00107722 


. . .QUE 


KHTUE 


GEN 


50. 


00040000 


SYO 


-00144024 


. . . TMC 


30SEP 


GEN 


50. 


00043700 


SYO 


-01106661 


EX1 


210CT 


GEN 


50. 


00055700 


SYO 


-00132564 


EX2 


210CT 


GEN 


50. 


00055700 


SYO 


-00132564 


EXST 


210CT 


GEN 


50. 


00055700 


SYO 


-00132564 


EX3 


210CT 


GEN 


50. 


00055700 


SYO' 


-00132564 


HT1 


220CT 


GEN 


50. 


00107400 


SYO 


-00425313 


TT12 


18JAN 


GEN 


50. 


00112600 


SYO « 


-00546303 


TT23 


M1332 


GEN 


50. 


00156400 


SYO 


-00134222 
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>PAR 

CEXPAR 

TTPAR 

EXCOH1 

EXC0M2 

SYSPAR 

TKNPAR 

DRVPAR 



LDRPAR 
BASIC2 
FCSRES 
TSTPAR 
GEN 



NT.PCL 
NT.NSP 
NT.AUX 
POOL, . 



114734 
114670 
114624 
114560 
114514 
114450 
114404 
114340 
114240 
114140 
114040 
113740 
113640 
113540 
113440 
113340 
113240 
113104 
112450 
112404 
112340 
112274 
112230 
112164 
045174 
061140 
046100 
046160 
046034 
100544 
075740 
045430 
046370 
046270 
044770 
047560 
060534 
062434 
062220 
073370 
070750 
045240 
071730 
076224 
074554 
076760 
071040 
075650 
100610 
062634 
053244 
062264 
061074 
045034 



00115000 
00120000 
00160000 
00174700 
00203100 
00215100 
00225100 
00225100 
00227200 
00230400 
00233500 
00236500 
00237600 
00240700 
00242300 
00245000 
00247600 
00251100 



oo; 



5400 



00255700 
00260400 
00320400 
00360400 
00460400 
00460400 
00466700 
00507200 
00526500 
00572500 
00643600 
00666000 
00723600 
00767600 
01013600 
01046000 
01062100 
01111100 
01155100 
01232000 
01300100 
01362200 
01516200 
01650500 
01760100 
02112100 
02172100 
02324400 
02402300 
02777700 
03671600 
03675300 
03713300 
03714400 
03776300 



00003000 
00040000 
00014700 
00006200 
00012000 
00010000 
00030600 
00002100 
00001200 
00003100 
00003000 
00001000 
00001100 
00001400 
00002500 
00002600 
00001300 
00004300 
00000300 
00002500 
00040000 
00040000 
00100000 
03317400 
00006300 
00014200 
00017000 
00044000 
00044000 
00013600 
00023300 
00044000 
00024000 
00032200 
00014100 
00027000 
00044000 
00020300 
00025600 
00055700 
00132000 
00132300 
00107400 
00132000 
00060000 
00132000 
00055700 
00112600 
00153100 
00003500 
00016000 
00001100 
00061700 
00001500 



MAIN 

MAIN 

MAIN 

MAIN 

MAIN 

MAIN 

MAIN 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

MAIN 

MAIN 

MAIN 

MAIN 

MAIN 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 

SUB 



COM 

TASK 

COM 

COM 

TASK 

TASK 

SYS 

DRIVER -DB: 
DRIVER -DK: 
DRIVER -DM: 
DRIVER -DR i 
DRIVER -EM: 
DRIVER -DT: 
DRIVER ~DX: 
DRIVER -DL: 
DRIVER ~DD: 
DRIVER -LP: 
DRIVER -MM: 
DRIVER -CO: 
TASK 
COM 
COM 
TASK 
SYS 

( PMT ♦ . ♦ ) 
(EVP, . . ) 
(COT, . . ) 
(UKFFCP) 
(SYOFCP) 
(MTAACP) 
(RMHACP) 
(DB1FCP) 
( DB2FCP > 
( QMG ♦ ♦ . ) 
(LPO ) 
(RMDEMO) 
(F11ACP) 
( . . ,MCR) 
(NETACP) 
(EXST ) 
( . . . EDT ) 
( . . .PIP) 
(HT1 ) 
(EDTT22) 
( ♦ . .AT, ) 
(EDTT16) 
(EX2 ) 
(TT12 ) 
( . . . TKB ) 
DYNAMIC 
DYNAMIC 
DYNAMIC 
DYNAMIC 
DRIVER -HT: 
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>SET TERMINAL / M C R 
> TIME 

20?11?56 06-JAN-82 

Q >dem mm ; 

MMOJ TT20J - Private Loaded 

MM1 1 Loaded 
Q > QUE /LI 

** PRINT QUEUES ** 

PRINT => LPO 

LPO => LPO 
© >DEv 

HTOJ Offline Lo3ded 

HT1J Offline Loaded 

HT2 < Offline Loaded 

HT3 ♦ Offline Loaded 

LPOi Loaded 

DBO J Loaded Type=RP05 

DB1! Public Mounted Loaded Label=llMDEV Type=RP06 

DB2 » Public Mounted Loaded Lsbel=RSXUTIL Type = RP06 

DDOJ Offline Loaded 

DDI J Offline Loaded 

DKO: Loaded 

DKli Loaded 

DK2: Loaded 

DK3J Loaded 

DLO ♦ TT20: - Private Loaded Type=RL01 

DLi: Loaded Type-RLOl 

DL2 » Loaded Type = RL02 

DM0 { Offline Loaded Type=RK06 

DM1 t Loaded Type=RK06 

DM2: Loaded Type=RK07 

DROi Public Mounted Loaded Label =GU AS ARUSERS T«pe=RP07 

DRi: Loaded Type=RM03 

DSO: Offline Unloaded Type=RS04 

DSi: Offline Unloaded Type=RS04 

DTO: Loaded 

DTI J Loaded 

DX0: Loaded 

DX1J Loaded 

EMO ♦ Offline Unloaded Type=ML 1 1 

MMO J TT20: - Private Loaded 

MMi: Loaded 

COO: Loaded 

NSOJ Public Mounted Loaded 

TTO: Loaded 

TT1J Loaded 

TT2 ♦ Loaded 

TT3J Loaded 

TT4» Loaded 

TT5« Loaded 

NLOJ 
TIOJ 

clo: lpo: 

lbo: dro: 

syo: dro: 
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PRIVILEGED COMMANDS 

There are commands that could possibly harm the work of other 
users and even affect system performance. These are privileged 
commands. To execute these commands you must either have an 
account with a group number of 10 or less (a system user, also 
called a privileged user) or have had your terminal set to 
privileged by a system user. Table 2-10 lists some of the 
commands that require having privileges to perform them. If at 
any time you need to perform a privileged command and do not have 
a privileged account, see your system manager or a system 
programmer for help. 



Table 2-10 Partial List of Privileged Commands 



User Wants To 


DCL Command 
to Use 


Install a task in the STD 


INSTALL 


Run a task on a time-based interval 


RUN 




Broadcast a message to all terminals 


BROADCAST 


Dismount any mounted volume 


DISMOUNT 


Set the time and day 


SET 


DAYTIME 


Set a terminal to slave 


SET 


TERMINAL 


Create partitions and subpartitions 


SET 


PARTITIONS 


Enable or disable logins 


SET 


SYSTEM 


Set the privilege status of a terminal 


SET 


TERMINAL 


Allocate checkpoint space 


SET 


DEVICE 


Change the priority of a running task 


SET 


PRIORITY 


Fix a task in memory 


FIX 




Remove an entry from the STD 


REMOVE 
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INTERPRETING ERROR MESSAGES 



Error messages are returned when you have improperly supplied 
information in a command line, or the operating system wants to 
inform you that what you have requested is not available. 

The error message format is shown below. Table 2-11 shows 
some common error messages. 



Error Message Format 



>MCR- 



-NOT LOGGED IN 




o 



e 



>DCL- 



- ILLEGAL COMMAND 




O Task from which the error was generated 
Q Message describing the error condition 
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Table 2-11 Some Common Error Messages 
Message Explanation 



MCR — Not logged in 



HEL — Other user logged on 



HEL — Logins are disabled 



You tried to enter a command 
before logging in. Type LOGIN or 
HELLO. 

Someone left the terminal without 
logging out. Type LOGOUT or BYE, 
then log in. 

Usually means system is still 
in the process of starting 
up, or is being shut down. 
If it persists, see your 
system manager or instructor. 



MCR — Task not in system The task you specified was not 

located in the installed task 

DCL — Illegal command The command you issued was not 

a DCL command. 



LEARNING ACTIVITIES 

1. READ Chapter 1, Introduction to MCR, in 
the RSX-11M/M-PLUS MCR Operations Manual . 

2. READ Appendix A: Common Error Messages, 
in the RSX-11M/M-PLUS Command Language 
Manual . 

3. DO the Lab Exercises for this module. 
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CREATING AND MODIFYING FILES 



INTRODUCTION 

Users spend considerable time creating and modifying text 
files. Text files are files consisting of ASCII characters - 
either straight text (e.g., a letter or a manual) or source text 
(e.g., a MACRO or FORTRAN program). There are a number of DEC 
editors available for this purpose. 



In this module, you will learn to use one of the more 
powerful DEC editors, EDT. In another module, you will learn some 
additional techniques available with EDT. The two modules 
together cover a subset of the full range of EDT facilities needed 
for most file editing. After you become adept at using this 
editor, read over the resources below to find some short cuts and 
even more sophisticated techniques. 



OBJECTIVES 

1. Invoke the EDT editor, execute editor commands, and exit 
from the editor. 

2. Use the editor to perform the following functions: 

a. Create text files. 

b. Change existing text files using line-oriented and 
character-oriented editing techniques. 

c. % Produce output files containing the results of an 

editing session. 



RESOURCES 

EDT Editor Manual 
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OVERVIEW 

There are many devices used to input data into the computer. 
Everything from magnetic tape to pressure and temperature 
measuring devices can send information to the CPU, memory or disk. 
However, these are mechanical devices that do not allow for human 
interaction. Not long ago punched cards were the most popular 
method used for inputting data. Today, we consider that method 
rather archaic and use instead a faster, more interactive device, 
the terminal. 



Purpose of an Editor 

A text editor is an interactive task used in conjunction with 
a terminal to create and edit ASCII text files that are stored on 
disk. It is used to create: 

- documentation files 

- memo files 
program source files 

- program data files 

Figure 3-1 shows the process of creating a text file using 
EDT, DIGITAL'S standard editor. A user, sitting at a terminal, 
will invoke the editor and after supplying the proper commands for 
specifying a new file name and indicating the input mode, will 
start inputting the lines of desired text. The editor program 
collects the string of characters (exactly as typed) into a buffer 
until the user terminates the input mode. It is not until the 
user instructs the editor to save the buffer that a file is 
written to disk to preserve the editing session. The file written 
to disk is in ASCII format; no translation has been performed on 
its contents. The contents of the file may be viewed at the 
terminal with the aid of a utility task. 

Figure 3-2 shows the process of editing a text file that 
already exists. When the name of an existing file is supplied to 
the editor, a copy of that file is read into the editor's main 
buffer. The editor then waits for commands to change the copy of 
the file that exists in this buffer. Once again, those changes 
are not reflected in a disk file until the user instructs the 
editor to save the contents of the buffer. When such a command is 
issued, a new copy (version) of the file is written to disk. 
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Figure 3-1 Creating a Text File 



> EDIT/EDT NEW TXT 

* % WH 

1 THIS IS A LINE 

2 THIS IS ANOTHER 

* DELETE 2 

* EXIT 



MEMORY 




GEN 



EDT BUFFER 
(MAIN) 



EDT 



EXEC 



A COPY OF 
OLD FILE 
READ IN 



SY: 

[305,303] 



A NEW COPY 
WRITTEN OUT 



NEW.TXT;1 



NEW.TXT;2 



IN EDITING AN EXISTING FILE: 

Q A COPY OF THE EXISTING FILE 

IS READ INTO THE BUFFER 

FROM DISK. 
A CHANGES ARE RECORDED IN 

THE BUFFER. 
A A NEW FILE IS WRITTEN OUT 

TO DISK WHEN INSTRUCTED BY 

THE USER. 
Q ORIGINAL DISK FILE IS 

LEFT UNTOUCHED. 
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Figure 3-2 Modifying Existing Text Files 



CREATING AND MODIFYING FILES 



EDT Editor Features 

EDT is a text editor that is available on many of DIGITAL'S 
operating systems. It offers many features that make text editing 
easier and more efficient. These features are listed below. 

• DIGITAL'S standard editor 

• Line mode/character mode - EDT performs editing operations 
on a line-by-line or character-by-character basis. In 
line mode the cursor position is always at the left-most 
side of the display. In character mode the cursor moves 
freely from left to right and up and down on the display. 

• English-like commands 

• Help facility 

• File protection by journaling - While performing your 
editing operations, EDT is recording all the keystrokes in 
a file. If for any reason the editing session abnormally 
terminates, this file is available for processing to 
recover what has been edited. 

• Startup command files - The editor reads a special file 
containing editing commands that create a processing 
environment tailored to the user's preferred methods of 
editing . 

• Redefine key functions 

• Multiple buffers and file access - A buffer to an editor 
user is like a sheet of paper to a writer. A writer might 
want a long sheet of paper to write his story and another 
sheet on which to make notes. More than one buffer can be 
created in EDT. These alternate buffers can be used to 
store things like notes, routines, or editing commands. 
Other files may be read into a buffer and searched without 
having to exit from the editor. EDT also provides for 
reading and writing other files while remaining in an 
editing session. 

• Automatic backup - The editor always creates a new file 
for the user leaving the previous version intact. 

• Macro capability - A powerful feature of the editor is the 
ability to create new commands that are made up of a 
series of editing commands. The new command is issued 
just like a standard editor command. This expands the 
functionality of the editor to whatever the user is able 
to create. 
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CREATING A TEXT FILE 

Example 3-1 shows the procedure for creating a text file. 



O > 

•>EDIT/EDT NEW * TXT 
Input file does not exist 
CE0B3 
O * I 

TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL. BELIEVE YOU, TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE, 

UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 
TEMPERATURE? VOLUME? HUMIDITY.* AND OTHER V A I \ I \ R I A BLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 
ANY GIVEN PROGRAM? WHEN RUNNING IS OBSOLETE, 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 

HEOB3 

^ E X I T 

DR0:C305»303DNEU.TXT»1 11 lines 



Example 3-1 Creating a Text File 



Notes on Example 3-1 

The following comments are keyed to the example. 

Q DCL command EDIT used to invoke, an editor. /EDT qualifier 
tells which editor to use. The file name NEW. TXT is 
supplied. EDT responds by indicating that the file does 
not exist and displays the "end of buffer" ( [EOB] ) symbol 
to indicate an empty buffer. 

Q (*) is EDT 1 s prompt indicating that it is ready to accept 
commands. EDT, by default, begins in line mode. In line 
mode the cursor always remains at the left-most position 
of the display and only moves forward and backward 
line-by- line in the file. All operations are performed 
on a complete line. To enter lines of text issue the 
I [NSERT] command. The cursor moves over and waits for 
your input. Although not displayed here, EDT assigns line 
numbers to the lines of text that are entered. This input 
mode is terminated by typing <CTRL/Z>. 

O EDT prompts (*) to indicate that it is again ready to 
accept commands. The EXIT command is issued to save the 
contents of the main buffer into a disk file. 
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Q EDT responds to indicate completion of the exit function 
by displaying the complete file specification, including 
the version number and number of lines saved in the file. 
Version numbers are octal numbers, beginning at 1 for a 
new file and increasing by 1 for every edit of that file. 

Q EDT returns control to the system, and the operating 
system displays its prompt indicating readiness to accept 
another command. 



EDITING AN EXISTING FILE 

Example 3-2 shows the process of editing an existing file. 



O 

o 



>E'D I TV EDT 
:l 

*%WH 

1 
2 

3 
A 



NEW, TXT 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE . 



6 
7 
8 
9 
10 
11 
CE0B3 
*EXIT 

DR0IC305f303 3NEW«TXTJ2 11 



UNDER THE MOST RIGOROUSLY CONTROLLED C0NITI0NS OF PRESSURE 
TEMPERATURE r VOLUME, HUMIDITY > AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES ♦ 
ANY GIVEN PROGRAM t WHEN RUNNING IS OBSOLETE ♦ 



THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 



lines 



Example 3-2 Editing an Existing File 



Notes on Example 3-2 

The numbered comments are keyed to the example. 

The editor is invoked using the DCL command and qualifier 

specifying EDT. A file name is supplied referencing an 

existing file. The contents of that file are read into 
the EDT buffer. 
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Q EDT prompts and a command is issued to display the 
complete buffer ending with [EOB] symbol. Line numbers 
are displayed which reference a particular line or range 
of lines in EDT commands. They are present only during 
the terminal session, and not saved in the output file. 
The exit command is issued to save another version of the 
file. 

Q EDT responds that the save operation is complete, and 
shows the new file specification and version number. A 
directory taken on NEW. TXT produces the following: 



>DIR NEW, TXT?* 

Directory DRO } C 305 * 3033 
6-JAN-82 22J39 

NEW ♦ TXT i 1 2. 15-DEC-81 16:51 

NEW . TXT r 2 2. 06-JAN-82 22J39 

Total of 4./7. blocks in 2. files 



Just as you have a HELP function at the operating system 
level, EDT also has a HELP command to provide information about 
the commands available to you in line mode. Issuing the HELP 
command gives you a list of all the commands for which information 
is provided. To obtain help for a command or a subtopic of a 
command , type HELP along with the command name and subtopic as 
shown in the second and third examples below. Example 3-3 shows 
how to access the HELP command. 



Command Format 



THE HELP FACILITY 



* HELP<RET> 



* HELP C0PY<RET> 
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>EDIT/EDT NEW* TXT 

1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

* HELP 
1 HELP 

You can get help on s topic by typing 

HELP topic subtopic subsubtgpie ♦ . ♦ 

A topic can have one of the following forms* 

1* An alphanumeric string (e*g* a command name* option* etc*) 
2» The match-all or wild card symbol (*) 

Examples J HELP SUBSTITUTE NEXT 

HELP CHANGE SUBCOMMAND 
HELP CH 

If a topic is abbreviated* the text for all topics which match the 
abbreviation is displayed* 



Additional information available* 

KEYPAD CLEAR CHANGE COPY DEFINE 

DELETE EXIT FILL FIND INCLUDE 

INSERT JOURNAL MOVE PRINT QUIT 

REPLACE RESEQUENCE RANGE SET SHOW 

SUBSTITUTE TABS TYPE WRITE 
# HELP COPY 

The COPY (abbreviation! CO) command copies text from one location to 
another within a buffer or between buffers* When text is copied* 
the source text remains intact. 



Format ♦ 



COPY [range- ID TO Crange-23 [/QUERY] [/DUPLICATE ♦ n3 



The lines specified by range-1 are copied in front of the first line 
specified by range-2* Either range defaults to the current line* 



If the destination is not the current buffer* put the name of the 
receiving buffer immediately after TO (=buffer)* Give the 
full name of the buffer* To copy text from an external file* see 
INCLUDE ♦ 



Additional information available? 
/DUPLICATE /QUERY 

♦ HELP COPY /QUERY 
Format: /QUERY 

When you use the /QUERY (abbreviation? /Q) Qualifier* EDT prompts you 
with a '?' to verify each line to be copied* 

Responses are* 

Y Yes* copy this line 

N No* do not copy this line 

Q Quit* do not copy any of the rest of the lines 

A All* copy all the rest of the lines 



* EXIT 

DR0J[305»3033NEW*TXT»3 11 lines 



Example 3-3 HELP Command 
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EDITING COMMANDS USING LINE MODE 

Once you have entered some text into the EDT buffer, you can 
issue commands that alter the contents of the buffer. Such 
commands allow you to copy lines, move them, delete them or change 
the text within the line. Table 3-1 lists some of the commands 
available in line mode. 



Table 3-1 Line Mode Commands 

Information on EDT commands and syntax 

To display lines on terminal 

To create a file or insert lines 
in an existing file 

To delete lines 

To duplicate lines within a file 
To change the location of some lines 
To change a text string within a line 
To renumber line numbers 

To change from line mode to character mode 

To execute a sequence of EDT commands 
contained within the text buffer 

Information on buffers, terminal settings 

To terminate EDT session without saving 
contents of the main buffer 

To terminate EDT session by saving 
contents of the main buffer 



EDT Command 
To Use 

HELP 

T [ YPE] 

I [NSERT] 
D[ELETE] 
CO[PY] 
M[OVE] 

SUBSTITUTE] 
RES [EQUENCE] 
C [HANGE] 

DEFINE MACRO 
SH[OW] 

EX[IT] 
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COMMAND MODE COMMANDS 



Displaying Lines 



The TYPE command is used to display lines of text at the 
terminal. It takes as a parameter a range of line numbers to be 
displayed. This is the default command for the editor, so if you 
only supply a range of lines, EDT assumes that you mean the TYPE 
command. This is generally the way the type command is used. 
Table 3-2 shows acceptable range specifications. A convenient 
feature in specifying a range of lines is the ability to mix 
numerics and mnemonics. For example, the following is an 
acceptable range for specifying lines 5 through the end of the 
file: 5:E. 

The TYPE command also changes the current line pointer. If 
you are at line 1 and type line 10, when it finishes typing, your 
current line is line 10. If you type 2:5, when it finishes 
typing, your current line is line 2. Example 3-4 shows how to use 
the TYPE command. 



Command Format 



Q EDT command name to type lines on the terminal; everything 
within brackets is optional. 

Q Range of lines to be typed in the general form: 

FIRSTLINE : LASTLINE . 




o 



o 



o 



O Command line terminator. 
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Table 3-2 Range Specifications 



User Wants to Indicate 

The current line 

An explicit single line number 

Lines 5 through 10 

5 lines beginning with line 5 

A single line which is the current 
line plus three lines 

A single line equal to the current 
line minus three lines 

A range of lines from the current 
line through the current line plus 10 

The whole buffer; first line 
through the last line 

The first line of the buffer 

The last line of the buffer 

All lines before the current line 

All lines after the current line 



Range 

Specification 



5 

5:10 
5#5 

+ 3 

. :+10 

WH[OLE] 
BE [GIN] 
E[ND] 
BEF [ORE] 
R [EST] 
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>EDIT/EDT NEW, TXT 

1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

♦TYPE 5 ?10 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 

6 TEMPERATURE t VOLUME r HUMIDITY » AND OTHER VARIABLES THE 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES ♦ 

8 ANY GIVEN PROGRAM r WHEN RUNNING IS OBSOLETE ♦ 
9 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

*T 9 

9 

*2#5 

2 AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE « 
4 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 

6 TEMPERATURE t VOLUME t HUMIDITY r AND OTHER VARIABLES THE 

*XWH 

1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

2 AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE ♦ 
4 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 

6 TEMPERATURE » VOLUME * HUMIDITY? AND OTHER VARIABLES THE 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES . 

8 ANY GIVEN PROGRAM r WHEN RUNNING IS OBSOLETE ♦ 
9 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

11 TO THE LEVEL OF MANAGEMENT ♦ 
CEOBD 

*6 

6 TEMPERATURE > VOLUME » HUMIDITY, AND OTHER VARIABLES THE 

*-4 

2 AND HE'LL BELIEVE YOU . TELL HIM A BENCH HAS WET PAINT 

*+8 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

# . 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

*-5 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 

*+2 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES. 

*. 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES. 

* . -2 

^5 UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 

*6 

6 TEMPERATURE t VOLUME* HUMIDITY, AND OTHER VARIABLES THE 

♦EXIT 

DR0:L305,3033NEW.TXTM 11 lines 



Example 3-4 TYPE Command 
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Inserting Lines 

When you are creating a new file or adding to an existing 
file, the INSERT command is used to add lines of text. INSERT 
takes as a qualifier the range of where the text is to be added. 
The editor inserts the added text before the specified line 
number. When adding multiple lines after INSERT is entered, the 
cursor moves over two tab stops and waits for the lines of text to 
be typed. To terminate the input process, a <CTRL/Z> must be 
typed. When the (*) prompt is displayed, EDT is ready to accept 
another command. 

When inputting a single line of text, the line of text is 
added to the command line (see the second example below) when the 
insert command is issued. You need not type <CTRL/Z>. After 
inserting the text line, EDT prompts for more commands. It does 
not wait for further input lines. Example 3-5 shows how to use 
the INSERT command. 



Command Format 




o 



e 



e 



H 10;PUT 




o eo 



o o 



O EDT command to insert text 

O Line number range 

Q Delimiter 

Q Line of text to be entered 

O Command line terminator 
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*i 10 

A MEETING IS AN EVENT AT WHICH THE MINUTES ARE KEPT 

AND THE HOURS ARE LOST. 

"Z 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
*s: 12 

8 ANY GIVEN PROGRAM t WHEN RUNNING IS OBSOLETE ♦ 
9 

9.1 A MEETING IS AN EVENT AT WHICH THE MINUTES ARE KEPT 

9.2 AND THE HOURS ARE LOST. 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

11 TO THE LEVEL OF MANAGEMENT. 
*I 10? ALL'S WELL THAT ENDS. 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

*a: 12 

S ANY GIVEN PROGRAM* WHEN RUNNING IS OBSOLETE. 
9 

9.1 A MEETING IS AN EVENT AT WHICH THE MINUTES ARE KEPT 

9.2 AND THE HOURS ARE LOST. 

9.3 ALL'S WELL THAT ENDS. 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

11 TO THE LEVEL OF MANAGEMENT. 
*ZWH 

1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

2 AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 
4 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 

6 TEMPERATURE t VOLUME* HUMIDITY* AND OTHER VARIABLES THE 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES. 

8 ANY GIVEN PROGRAM * WHEN RUNNING IS OBSOLETE. 

9 

9.1 A MEETING IS AN EVENT AT WHICH THE MINUTES ARE KEPT 

9.2 AND THE HOURS ARE LOST. 

9.3 ALL'S WELL THAT ENDS. 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

11 TO THE LEVEL OF MANAGEMENT. 
CE0B3 



Example 3-5 INSERT Command 
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LEARNING ACTIVITIES 

READ the following in the EDT 
Reference Manual ; 

• Chapter 1, Introduction to EDT 

• Chapter 2, Sample Editing Sessions 
Getting Started and Line Editing 
Sections 

• Chapter 6, Line Numbers, Text Buffers 
and Ranges 

• Chapter 7, Line Editing - Insert 
command 

DO the following at your terminal: 

a. Create a file with the name TEST. TXT. 
Insert the line "The quick brown fox 
jumped over the lazy dog's back." 
three times. 

b. Exit from the editor, saving the 
lines in a file. 

c. Reedit the file and issue the HELP 
command . 

d. Obtain HELP on TYPE. 

e. Display the lines in your file by 
issuing the following command: 

TYPE W 

The line numbers will appear with the 
lines of text. 

f. Exit from the editor. 
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Deleting Lines 

To remove lines from the text buffer use the DELETE command. 
The QUERY qualifier enables the user to selectively delete lines 
within a range of lines. When this form of the command is used, 
the editor displays the first line in the range of lines and then 
waits for the user to respond with "Y" for yes (meaning to delete 
the line), "N" for no, "A" for all (delete all remaining lines in 
the range) or "Q" for quit (do not delete any of the remaining 
lines in the range). Example 3-6 shows how to use the DELETE 
command . 



Command Format 




o 



e 



o 




o 



e 



e 



o 



o 

e 
e 
o 



EDT command to delete lines 



Range specification 



Command qualifier 



Command line terminator 
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2 AND HE'LL BELIEVE YOU ♦ TELL HIM A BENCH HAS WET PAINT 

*D 8 

1 line deleted 

9 

* D 9 ♦ 1 t 9 . 4 

3 lines deleted 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

*XWH 

1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

2 AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE ♦ 
4 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 

6 TEMPERATURE t VOLUME* HUMIDITY r AND OTHER VARIABLES THE 

7 ORGANISM MILL DO AS IT DARN WELL PLEASES . 
9 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

11 TO THE LEVEL OF MANAGEMENT . 
CE0B3 

♦ D9 5 10 /Q 

9 

? N 

9.1 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS LONG AS ITS ELECTRIC 

AL 

?N 

9.2 CORD. 

?N 

9.3 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS LONG AS ITS ELECTRIC 

AL 

?Y 

9.4 CORD. 

?Y 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

?N 

2 lines deleted 

11 TO THE LEVEL OF MANAGEMENT. 

*?:n 

9 

9.1 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS LONG AS ITS ELECTRIC 

AL 

9.2 CORD. 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

11 TO THE LEVEL OF MANAGEMENT. 



Example 3-6 DELETE Command 
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Copying Lines 

To copy a range of lines to another section of the file, use 
the COPY command. The original lines remain intact and a 
duplicate set of lines is inserted at the new location. The copy 
command also allows you to selectively copy lines within a range 
of lines (as shown in the second command example below) and also 
to make more than one copy of the lines (as shown in the third 
command example). Example 3-7 shows how to use the COPY command. 



Command Format 

*CO[PY] 1 :4 TO E <RET> 

*CO[PY] 1:4 TO 1 3/Q<RET> 

*CO[PY] 1:4 TO 13/DUPLICATE:2<RET> 



*CQ 114 TO I::.' 
4 lines copied 
*/£WH 

:l. TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

2 AND HE'LL BELIEVE YOU * TELL HIM A BENCH HAS WET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE * 
4 

4*1 ALL'S WELL THAT ENDS * 

4 * 2 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 

6 TEMPERATURE r VOLUME y HUMIDITY > AND OTHER VARIABLES THE 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES » 

8 ANY GIVEN PROGRAM ? WHEN RUNNING IS OBSOLETE, 
9 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

.1.1 TO THE LEVEL OF MANAGEMENT * 

12 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

13 AND HE'LL BELIEVE YOU , TELL HIM A BENCH HAS WET PAINT 

14 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE* 
15 

i:egb::i 

DROtC 305*303 3 NEW* TXT J 5 17 lines 



Example 3-7 COPY Command 
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Moving Lines 

To change the physical location of a line or group of lines, 
use the MOVE command. This command moves the lines defined by the 
first range specified, to the location preceding the line 
specified by the second range. In sheet one of Example 3-8, the 
MOVE command is issued to move lines 1 through 4 to line 20. 
Notice that when the complete buffer is displayed, lines 1 through 
4 no longer precede line 5 and are now positioned before line 20. 
They now have line numbers 19.1 through 19.4. 



Command Format 
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*Xwh 

1 TELL A MAM THERE ARE 300 BILLION STARS IN THE UNIVERSE 

2 AND HE'LL BELIEVE YOU* TELL HIM A BENCH HAS MET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 
4 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 

6 TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES. 
8 

9 ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

10 

11 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 

12 LONG AS ITS ELECTRICAL CORD. 
13 

14 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

15 TO THE LEVEL OF MANAGEMENT. 
16 

17 A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 

18 FINAL INSPECTION. 
19 

20 
21 
CE0B3 

*m 114 to 20 
4 lines itoved 

*%wh 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 

6 TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES. 
8 

9 ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

10 

11 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 

12 LONG AS ITS ELECTRICAL CORD. 
13 

14 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

15 TO THE LEVEL OF MANAGEMENT. 
16 

17 A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 

18 FINAL INSPECTION. 
19 

19.1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

19.2 AND HE'LL BELIEVE YOU ♦ TELL HIM A BENCH HAS WET PAINT 

19.3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE . 
19.4 

20 
21 
CE0B3 



Example 3-8 MOVE Command (Sheet 1 of 2) 
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1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

2 AND HE'LL BELIEVE YOU* TELL HIM A BENCH HAS WET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 
4 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 

6 TEMPERATURE* VOLUME* HUMIDITY * AND OTHER VARIABLES THE 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES* 
8 

9 ANY GIVEN PROGRAM* WHEN RUNNING IS OBSOLETE. 

10 

11 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 

12 LONG AS ITS ELECTRICAL CORD. 
13 

14 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

15 TO THE LEVEL OF MANAGEMENT. 
16 

17 A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 

18 FINAL INSPECTION. 
1? 

20 
21 
CEOEO 



*m 1 : 6 to 21 /a 



?y 


1 


TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 


?y 
?y 


2 


AND HE'LL BELIEVE YOU* TELL HIM A BENCH HAS WET PAINT 


3 


ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE* 


?n 
?n 
?r. 


4 

5 


UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 


6 


TEMPERATURE. VOLUME > HUMIDITY* AND OTHER VARIABLES THE 



3 lines Moved 

*%wh 

4 

5 UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 

6 TEMPERATURE* VOLUME* HUMIDITY* AND OTHER VARIABLES THE 

7 ORGANISM WILL DO AS IT DARN WELL PLEASES. 
8 

9 ANY GIVEN PROGRAM* WHEN RUNNING IS OBSOLETE. 

10 

11 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 

12 LONG AS ITS ELECTRICAL CORD. 
13 

14 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

15 TO THE LEVEL OF MANAGEMENT. 
16 

17 A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 

18 FINAL INSPECTION. 
19 

20 

20.1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

20.2 AND HE'LL BELIEVE YOU . TELL HIM A BENCH HAS WET PAINT 

20.3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 
21 

CE0B3 



Example 3-8 MOVE Command (Sheet 2 of 2) 
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Text Substitution 

When you wish to correct a typing error or a string of text 
within a line, you must use the SUBSTITUTE command. It is the 
only line mode command that will perform this function. The 
format of the command is shown below, and Example 3-9 shows the 
result of issuing the command. When you select a text string for 
correction, you must supply a unique character string for the 
editor to match, or unexpected results may occur. The Editor 
substitutes for every occurrence of the specified string, 
regardless of surrounding characters. In the second example 
below, s$the$a$16 : 19, the editor found a match in line 17 in the 
word "other", and made the substitution to give the word "oar". 
The result is logically correct, however, not exactly what was 
intended. The correct command would be s$ the $ a $16:19 (with 
spaces) . 

The format of the SUBSTITUTE command requires a delimiter to 
separate the fields of the command. In the first command example 
below, the slash is used to delimit the command name from the 
string to be substituted, and that from the replacement string. 
Any non-alphanumeric character can be used as a string delimiter 
provided you use the same delimiter in all places. An example of 
this is shown in the second command example. You use this feature 
when you want to remove a string of characters that contains a 
slash . 



Command Format 

*S/PR0GRAM/TASK/5 <RET> 
*S$THE$A$16:19<RET> 
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>ED IT/EDT NEW. TXT 

1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

2 AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 
4 

5 ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

6 

7 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 

8 LONG AS ITS ELECTRICAL CORD. 
9 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

11 TO THE LEVEL OF MANAGEMENT. 
12 

13 A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 

14 FINAL INSPECTION. 

15 

15 UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 

17 TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 

18 ORGANISM WILL DO AS IT DARN WELL PLEASES. 
19 

CE0B2 

*S/PR0GRAK/TASK/5 

5 ANY GIVEN TASK, WHEN RUNNING IS OBSOLETE. 

1 substitution 

*s*the*a*ig: 19 

16 under a most rigorously controlled conditions of pressure 

17 temperature, volume, humidity, and oar variables a 

3 substitutions 

*GUIT 



Example 3-9 SUBSTITUTE Command 
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Renumbering Lines 

During an active editor terminal session, it may be helpful 
to renumber the lines within the file. Although it is not 
possible to get line numbers out of sequence, they can become 
f ractionalized and cumbersome to use. Issuing the RES command 
resequences the complete file beginning with 1 and incrementing by 
1 for each line in the file. A range can be specified to 
resequence a particular section of the file. If the sequence 
qualifier is used, as in the second command example below, a 
starting sequence number and an increment number can be specified. 

This command renumbers lines 10 through the end of the file. 
Line 10 becomes line 100 and each line after that has a line 
number incremented by 10. Line 11 becomes 110, line 12 becomes 
120. In the command, the first parameter supplies the range of 
lines to be numbered. In the command qualifier, /SEQ, the first 
parameter is the starting line number and the next parameter is 
the increment value. Example 3-10 depicts using the RESEQUENCE 
command. 



Command Format 
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*res io:-/.e /seq: 100:10 

10 lines resequenccd 



*'/.WH 

1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

2 AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 
4 

5 ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

e 

7 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 

8 LONG AS ITS ELECTRICAL CORD. 
9 

100 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

110 TO THE LEVEL OF MANAGEMENT. 

120 

130 A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 

140 FINAL INSPECTION. 

150 

160 UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 

170 TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 

180 ORGANISM WILL DO AS IT DARN WELL PLEASES. 



190 
CE0B2 
*RES 

19 lines reseiuenced 
*7.WH 

1 TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 

2 AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 

3 ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 
4 

5 ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

G 

7 THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 

8 LONG AS ITS ELECTRICAL CORD. 
9 

10 THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 

11 TO THE LEVEL OF MANAGEMENT. 
12 

13 A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 

14 FINAL INSPECTION. 
15 

15 UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 

17 TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 

18 ORGANISM WILL DO AS IT DARN WELL PLEASES. 
19 

CE0B2 
*EXIT 

DB2T C 305, 303 2 NEW. TXT "6 19 lines 



Example 3-10 RESEQUENCE Command 
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Ending the Edit Session 

To terminate the editing session and to preserve the contents 
of the EDT buffer, use the EXIT command. A file is generated with 
the name supplied when you invoked EDT and a version number that 
is one higher than the input file version number. If you wish to 
give your file a different name than the one supplied at the 
beginning of your session, supply the file name along with the 
EXIT command, as shown in the second example below. 

The QUIT command terminates the editing session without 
saving the buffer contents in the file. Use QUIT when you are 
just examining the contents of a file, or when you have 
inadvertently corrupted the contents of a file. 

Command Format 

*EXIT<RET> 

*EXIT NEWER.TXT<RET> 

*QUIT<RET> 



LEARNING ACTIVITIES 

1. READ Chapter 7, Line Editing, in the 
EDT Reference Manual . 

2. DO Lab Exercises 1 and 2 for this module. 
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Character Mode Features 

In contrast to line mode where the cursor is always 
positioned at the beginning of a line and operations are performed 
on a line-by-line basis, character mode allows cursor positioning 
anywhere in the text buffer, and operations can be performed on a 
character-by-character basis. EDT shows immediate results of a 
keystroke which creates a great deal of activity on the screen. 
For example, if you delete a word, the letters are removed and the 
line is adjusted to close up the space where the word resided. 

This mode makes adding and deleting text within a line 
extremely simple. Using the keypad function keys, a complete word 
can be deleted with one keystroke. The following is a list of 
features that makes character mode so attractive. 

• Free form cursor positioning 

• Dynamic display of editing operations 

• Keypad function keys that perform specified operations in 
one keystroke 

• Instantaneous addition of text 

• Help facility 

• Cut and paste operation for moving blocks of text 

• Ability to use line mode editing commands 

• Ability to change between upper- and lowercase alphabetic 
characters 

• Ability to select a range of lines to limit line width 

• Ability to set tabs 

• Ability to define key functions 
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THE KEYPADS 

Figures 3-3 and 3-4 show the keypads of the VT100 and VT52 

terminals and include a diagram showing each key's function. Most 

keys have two functions. To invoke the lower function, the gold 
key must be pressed first. For example, if you wish to employ the 

TOP function on a VT100, you would first press the gold key (PF1) 
and then the TOP (5) key. 



VT100 Keypad Functions 



b — ^r? 



la 




5 



t3a 



(V ft 



\ 



fir 



la 

fy 



3t 



3 



i r — i — i — i i 1 — i 

| «' I °0«N | LEFT | RIGHT | | GOLD | HELP | ™ N * T | ^ | 

__l | | 1 



I J 



PAGE I SECT APPEND . DEL W 
| COMMAND FILL 'REPLACE UNO W 



I i 1 1 1 

I ADVANCE I BACKUP I CUT ' DEL C I 
BOTTOM | TOP I PASTE | UND C | 

I WORD I EOL CHAR I I 

|CHNGCASEI DEL EOL 1 SPECINS i I 

j ' "I ' SUBS R | 

I LINE I SELECT | 

I OPEN LINE 1 RESET 1 I 

l I L _J 



Figure 3-3 VT100 Keypad Functions 
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VT52 Keypad Functions 



v t , 

fr=<\ 



fV AfC 



"S^ify ^OfY 




• r\ iz i i ■ 



GOLD • HELP 



DEL L I UP 
UND L REPLACE 



h- r-i — |- J , 

PAGE I FNDNXT I DEL W I DOWN ■ 
COMMAND FIND UND W SECT I 



\—\ 1 1 1 

ADVANCE BACKUP I DEL C I RIGHT I 
BOTTOM I TOP | UND C I SPECINS | 

I 

1 

~l 



I — T 



■WORD IEOL ' CUT ' LEFT 
CHNGCASE DEL EOL PASTE I APPEND 



| J 



I" 



LINE 

OPEN LINE 



SELECT ENTER 
RESET I SUBS 



L 1__J J 



Figure 3-4 VT52 Keypad Functions 
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Changing to Character Mode 

When you invoke EDT, the mode that is active is line mode. 
To be able to work in character mode, issue the change command (a 
line mode command) as shown in Figure 3-5. When this is done, EDT 
erases the screen and starts displaying the first 22 lines of the 
buffer. Line numbers are not displayed, as they have no function 
in character mode. All operations are now dependent upon cursor 
positioning. Also, EDT does not display a prompt in character 
mode to indicate that it is ready to accept commands. When the 
cursor sits on the first character and blinks, EDT is ready to 
accept keystrokes. 



EDIT/EDT NEWtTXT 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM 4 BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 

UNDER THE, HOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME > HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



JELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HI" A BENCH HAS WET PAINT 
OM IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 

UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE , VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 



ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 



THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



TK-7865 

Figure 3-5 Changing to Character Mode 
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Positioning the Cursor 

To position the cursor a character or a line at a time, the 
arrow keys on the keypad can be used, as shown in Figure 3-6. 



r 

TELL A MAN THERE ARE 300 BILLION 
AND HE'LL BELIEVE YOU. TELL HI" 
ON IT AMD HE'LL HAVE TO TOUCH IT 



1 

vSTARS IN THE UNIVERSE 
A BENCH HAS WET PAINT 
TO BE SURE. 



UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 



ANY GIVEN PROGRAM , WHEN RUNNING IS OBSOLETE. 



THE ATTENTION SPAM OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CURD. 



THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



FUNCTION: 



POSITIONING THE CURSOR 



KEY PAD: 




DISCUSSION: f MOVES CURSOR UP ONE LINE 

-J MOVES CURSOR DOWN ONE LINE 

— ► MOVES CURSOR RIGHT ONE CHARACTER 
+ — MOVES CURSOR LEFT ONE CHARACTER 



Figure 3-6 Positioning the Cursor (Sheet 1 of 3) 
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EXAMPLES: 

USER TYPES 



RESULTS 



/ 



r 



TiTLL A MAN THERE ARE 300 BILLION STARS IN THE UNIVEPSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
OM IT AMD HFT'LL HAVE TO TOUCH IT TO BE SURE. 

UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTFNTIDN SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 

A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 




TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVEPSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON :§;T AND HE'LL HAVE TO TOUCH IT TO BE SURE. 

UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 

A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



Figure 3-6 Positioning the Cursor (Sheet 2 of 3) 
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EXAMPLES: (CONT) 
USER TYPES 



RESULTS 



ff 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
DN IT AND HE'LL HAVE TO TOUCH IT TO BE SURE , 

UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE , VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES, 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 

A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 

UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 

A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



Figure 3-6 Positioning the Cursor (Sheet 3 of 3) 
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Positioning the Cursor (Alternate Methods) 

Another method of moving the cursor (usually quicker) is to 
use the function keys in two key combinations, as shown in Figure 
3-7. 



^^^^^^^^^^^ 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 



UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETfc. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 



THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



FUNCTION: POSITIONING THE CURSOR 



| r 1 i 1 1 | 

| ADVANCE I BACKUP | I WORD I EOL | | LINE 

| BOTTOM | TOP I | CHNGCASE | DEL EOL | | OPEN LINE 

I L I I I I I 



DISCUSSION: ADVANCE - SETS CURSOR DIRECTION FORWARD (DEFAULT DIRECTION OF 

CURSOR). MOVEMENT REMAINS IN EFFECT UNTIL BACKUP IS 
DEPRESSED. 



BACKUP - SETS CURSOR MOVEMENT TOWARD THE START OF THE Fl LE 



TOP - POSITIONS CURSOR AT THE TOP OR START OF FILE. 

BOTTOM - POSITIONS CURSOR AT THE BOTTOM OF THE FILE BUT 
BEFORE [EOB] SYMBOL. 



WORD - MOVES THE CURSOR ONE WORD 

WORD = ONE OR MORE CHARACTERS PRECEDED AND 
FOLLOWED BY KEY SPACES. 

TK-7866 



Figure 3-7 Positioning the Cursor (Alternate Methods) 

(Sheet 1 of 4) 
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EOL - POSITIONS CURSOR AT THE END OF THE LINE 

LINE - POSITIONS CURSOR AT THE BEGINNING OF THE LINE 



EXAMPLES: 

USER TYPES 



RESULTS 



i 1 r 

I I 

I 



~1 



GOLD 



ADVANCE 
BOTTOM 



_J I I 



TELL A MAN THERE ARE 300 BILLIOM STARS IN THE UNIVERSE 
AMD HE'LL BELIEVE YOU. TELL HI" A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 

UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OE PRESSURE 
TEMPERATURE , VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD , 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 

A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



n r 



n 



| G0LD I I BACKUP I 

I I I T ° P | 
I I I I 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 

UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS DF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 

ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD . 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 

A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



Figure 3-7 



Positioning the Cursor (Alternate Methods) 
(Sheet 2 of 4) 
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EXAMPLES: (CONT) 

USER TYPES RESULTS 



I 1 

I EOL I 
| DEL EOL | 

I J 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 



UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 



ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 



THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 




TELL A MAN THERE ARE 300 BILL 
AND HE'LL BELIEVE YOU. TELL 
ON IT AND HE'LL HAVE TO TOUCH 



ION STARS IN THE UNIVERSE 
HIM A BENCH HAS WET PAINT 
IT TO BE SURE. 



UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 



ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 



THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT, 



A FAILURE WILL MOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



LINE 
OPEN LINE 



L_. 



Figure 3-7 Positioning the Cursor (Alternate Methods) 

(Sheet 3 of 4) 
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EXAMPLES: (CONT) 

USER TYPES RESULTS 



I 1 I 1 

| WORD | | WORD | 

| CHNGCASE | | CHNGCASE j 

I I I I 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 



UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 

ANY GIVEN PROGRAM , WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 



UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 



ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 



THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



r 



~i r 



I BACKUP | I WORD 
| TOP || CHNGCASE 

I I I 



Figure 3-7 Positioning the Cursor (Alternate Methods) 

(Sheet 4 of 4) 
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Inserting Text 

Inserting text in character mode is almost automatic. The 
only required operation is to position the cursor on the character 
in front of where you want to add the text. When the cursor is 
correctly positioned, you type the required text. This process is 
shown in Figure 3-8. 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVEPSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 



ANY GIVEN PROGRAM , WHEN RUNNING IS OBSOLETE. 



THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 



THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



FUNCTION: INSERTING TEXT 

KEYPAD: ANY KEYPAD KEY MAY BE USED TO POSITION 

THE CURSOR, ETC. HOWEVER, UNLIKE LINE 
MODE, THESE KEYS CAN NOT BE USED TO 
ENTER NUMERICS INTO A TEXT Fl LE. 



DISCUSSION: AFTER POSITIONING THE CURSOR TO THE 
PROPER POSITION, YOU CAN BEGIN TYPING 
THE DESIRED TEXT. IT Wl LL AUTOMATICALLY 
BE INSERTED INTO YOUR FILE IMMEDIATELY 
BEFORE THE CURSOR'S POSITION. 



EXAMPLE: 

USER TYPES RESULTS 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 



ALL'S WELL THAT ENDS. 



UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS OF PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 



ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 



THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION, 



Ul<RET> 

ALL'S WELL THAT ENDS <RET> 



TK-7870 



Figure 3-8 Inserting Text 
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Deleting Text 

To delete text, first position the cursor to the line, 
character, or word that is to be deleted, and then press the 
appropriate delete key on the keypad. If a piece of text was 
deleted in error it can be restored by first pressing the GOLD key 
and then the appropriate undelete key (UND C, UND L, UND W) . 
Figure 3-9 shows the process of deleting text. 



TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVEPSE 
AND HE'LL BELIEVE YOU. TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 



UNDER THE MOST RIGOROUSLY CONTROLLED CONDITIONS Of PRESSURE 
TEMPERATURE, VOLUME, HUMIDITY, AND OTHER VARIABLES THF 
ORGANISM WILL DO AS IT DARN WELL PLEASES. 



ALL'S WELL THAT ENDS. 



ANY GIVEN PROGRAM, WHEN RUNNING IS OBSOLETE. 

THE ATTENTION SPAN OF A COMPUTER IS ONLY AS 
LONG AS ITS ELECTRICAL CORD. 



THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT. 



A FAILURE WILL NOT APPEAR TILL A UNIT HAS PASSED 
FINAL INSPECTION. 



FUNCTION: DELETING TEXT 

I 1 I 1 I 1 I 

KEYPAD: ^ DEL C | I DELL I I DELW ' I EOL 

j UNDC | j UND L | j UNDW | j DEL EOL 

I I I I I I I 



DISCUSSION: AUTOMATIC DELETE FUNCTIONS ARE AVAILABLE FOR 
CHARACTER, WORD, LINE, OR PARTIAL LINES. IN 
ADDITION, THE DELETE KEY LOCATED ON THE 
KEYBOARD CAN BE USED TO DELETE A CHARACTER. 



J DELC I - DELETES THE CHARACTER ON THE CURSOR. 
I UNDC | 
1 I 

! 1 



DELETES A LINE FROM WHERE THE CURSOR 
IS TO THE END OF THE LINE INCLUD 
CARRIAGE RETURN AND LINE FEED. 



j DELL 1 IS TO THE END OF THE LINE INCLUDING THE 

I I 

I ' 

DELW 1 _ DELETES A WORD INCLUDING THE SPACES 
I I BEFORE AND AFTER. 

I I 

I 1 I 1 

I I | EOL | - DELETES A LINE FROM WHERE THE CURSOR 

I GOLD | | DEL EOL j IS TO THE END OF THE LINE. 

I I I I 



Figure 3-9 Deleting Text 
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Help Function 

The Help key on the keypad provides the same function as 
typing help in line mode. It provides a keypad/function diagram 
and instructions on how to get help on each of the keys used in 
character mode (Figure 3-10) . 



r 





1 


DOWN 


"T T~ 


1 


1 
1 


1 
1 
1 


1 1 

1 * 1 * 


j 

UP 


1 


♦ 


1 LEFT | RIGHT 


1 




1 1 



DELETE 

LINEFEED 

BACK SPACE 

CTRL/A 

CTRL/D 

CTRL/E 

CTRL/K 

CTRL/T 

CTRL/W 

CTRL/Z 



RUBOUT CHARACTER 
RUBOUT WORD 

BACKUP TO BEGINNING OF LINE 
COMPUTE TAB LEVEL 
DECREASE TAB LEVEL 
INCREASE TAB LEVEL 
DEFINE KEY 
ADJUST TABS 
REFRESH SCREEN 
RETURN TO LINE MODE 





r l 
1 


T 

FNDNXT | 


1 

DEL L | 


GOLD 


HELP 1 


I 


1 


FIND 


UND L , 


PAGE 


! 1 
j SECT 
1 


i r 

APPEND | 


DEL W j 


COMMAND 


FILL 


REPLACE 


UND W i 


ADVANCE 


1 

1 BACKUP 1 
1 


1 1 
1 CUT 1 

1 1 


1 

DEL C j 
1 


BOTTOM 


TOP 


PASTE 


UND C 



• WORD | EOL | CHAR | 



CMTCO 



TYPE A KEY FOR HELP ON THAT KEY. 
TO EXIT, TYPE A SPACE. 



CHNGCASE DEL EOL SPECINS 



OPEN LINE 



RESET 



SUBS 



Figure 3-10 VT100 Keypad Editing Help Text 



Exiting Character Mode 

When your work in character mode is finished, you can save 
your edit session in either of two ways. 

1. Press the GOLD and then the COMMAND function key. Type 
EXIT after the prompt and press the ENTER function key. 

2. Press <CTRL/Z> which returns you to line editing. After 
the (*) prompt, type EXIT <RET>. 
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LEARNING ACTIVITIES 

1. READ the following in the EDT 
Reference Manual ; 

• Chapter 2, Sample Editing Sessions 
Keypad Editing Section 

• Chapter 5, Keypad Editing 

2. DO Lab Exercises 3 through 6 for this 
module . 
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INTRODUCTION 

Most work on the system, directly or indirectly, involves 
files. You will need to obtain files from other users and/or 
transfer your own files to them, and keep track of files that you 
have created. System commands are available to allow the user to 
maintain files and directories. Some available functions are: 

• Listing directories of files 

• Deleting unwanted files 

• Renaming files 

• Making copies of files 

• Displaying files at the terminal 

• Printing files on the system printer 

This module focuses on these file operations. 

OBJECTIVES 

1. List directories of files. 

2. Delete unwanted files. 

3. Rename files. 

4. Make copies of files. 

5. Inspect the contents of files, using the terminal or a 
printer . 

6. Set the access which other users have to your files. 

RESOURCES 

1. RSX-11M/M-PLUS Command Language Manual 

2. Introduction to RSX-11M/M-PLUS 
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FILE STRUCTURE 
FILES- 11 

Another facility of an operating system that benefits its use 
is the task of storing, maintaining and locating files on 
auxiliary storage devices. This is done by a software system 
called FILES-11. To be able to locate and maintain files on 
volumes mounted on disk drives, floppy disks and DECtapes, 
FILES-11 uses a two-level directory structure, as shown in Figure 
4-1. For each volume, the structure consists of one Master File 
Directory (MFD) and one User File Directory (UFD) for each user on 
the volume. 



Master File Directory (MFD) 

The Master File Directory is a file located in the UFD [0,0] 
named 000000. DIR. It contains a list of all the UFDs located on 
the volume. 



User File Directory (UFD) 

In turn, a User File Directory (UFD) (Figure 4-2) is a 
directory file that keeps track of all files on the volume 
belonging to a user. A UFD is created when an account is 
established for a user, and is identified with the user's UIC. 
For example, if your UIC is [305,303], you would have a directory 
file in UFD [0,0] named 305303. DIR. 

A UFD can also be created later by using the DCL command 
CREATE/DIRECTORY. This command is also used to create a UFD on 
another volume, or another UFD on the same volume. A user may 
have a UFD on many different devices, but one device is set up to 
be the default device for the user. 
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[0,0] 000000.DIR 



• • • 



001002.DIR 



001054.DIR 



005002.DIR 



005003.DIR 



305303.DIR 



305304. DIR 



[0,0] 001002.DIR 



[0,0] 005003.DIR 



PROG.FTN 



PROG.LST 



PROG.FTN 



PROG.LST 



PROG.MAP 



PROG.TSK 



LOGIN.CMD 



[0,0] 305303. DIR 



PROG.MAP 



PROG.TSK 



[305,303] 



[305,303] [305,303] 



[305,303] 



MASTER 
> FILE 
DIRECTORY 



USER 
> FILE 
DIRECTORY 



> FILE 



Figure 4-1 FILES-11 Directory Structure 
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305303. DIR 


MFD 




305304.DIR 






• 






• 






• 











SY: [305,303] 



VIP.MAC 



VIP.LST 



VIP.MAP 



VIP.TSK 



_ PROG.FTN_ 
_ PROG.LST _ 
_ PROG.MAP_ 
_ PROG.TSK _ 

INFO.TXT _ 
VIP.OBJ _ 

PROG.OBJ_ 
PAYROLL.CBL_ 
_ LQGIN.CMD 

_ XYZ.MAC 
MACIO.MAC 



SY: [305,304] 



^ J_QG1N.CMD . 

^ STARTUP.CMD 

PRIMES.FTN 

_PR1MES.QBJ 

NOTICE.TXT , 

PRIME. LST . 

^ CLAMBAKE.TXT ^ 
^PRIMES.TSK_ ^. 
^ ADVENTURE.TSK , 
PRIMES.MAP 



UFD 



YOUR DIRECTORY ANOTHER USER'S DIRECTORY 

TK-7670 



Figure 4-2 User File Directories 
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User Default UFD 

When you successfully log in, the operating system grants you 
access to your User File Directory and all the files contained 
within it. This becomes your default UFD. Whenever a UFD is 
required syntax and is not supplied, the operating system will 
assume you mean your default UFD. It is possible and often to 
your advantage to change your default UFD to something other than 
the one you log in to. This is done using the DCL command SET 
DEFAULT, as shown in Figure 4-3. Example 4-1 shows the results of 
issuing the DIRECTORY command before and after using SET DEFAULT. 
The DIRECTORY command (which can be shortened to DIR) provides a 
listing of the files contained in a UFD. The first directory 
listing in the example is for UFD [305,303]. Because the UFD was 
not specified with the DIR command, the system assumes the user's 
default UFD. After issuing SET DEFAULT to change the default UFD 
to [305,304], DIR produces a listing for the second UFD. 



User Default Device 

It is also possible to change your default device. This is 
useful when you wish to work on a disk volume other than the 
default device set up for you when your account was established. 
By changing the default device, you will save having to specify 
the device every time you issue a command. SET DEFAULT is also 
used to change the default device. In both cases, the change is 
effective until the command is issued again or the user logs off. 



System UFDs 

Table 4-1 lists special UFDs established by the system 
manager when the operating system is generated. These UFDs 
contain files related to a particular subject. For example, the 
text files used to display HELP messages are stored in LB: [1,2]. 
The login message file is also stored in LB: [1,2]. 

Table B-3 in the RSX-11M/M-PLUS System Management Guide gives 
a complete list of the system UFDs. 
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DB2: 



DKO: 




DY1: 



[0,0] 



[305,304]^ 
[200,210] 



DS2: 



' 



[0,0] 



[305,303] 



DEFAULT UFD: 



[305,303] 



DEFAULT DEV: 



>SET DEFAULT DY1 : [305,304] 



DB2: 



DB2: DKO: DY1 : DS2: 




DY1: 



TK-7679 

Figure 4-3 Changing the Default UFD and Device 
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>DIR 



Directory DK2 ♦ C 305 » 3033 
15-DEC-81 11*>39 



LOGIN . CMD i 1 


1 ♦ 




04 


-AUG- 


81 


08M3 


VIP.TSKrl 


4 . 


C 


14 


-AUG- 


■81 


10148 


PAYROLL . CBL i 1 


2. 




08 


-JAN- 


81 


15131 


INF0.TXTJ1 


60, 




07 


-JUL- 


■80 


12M7 


LOGOUT. CMD?5 


1 , 




28 


-MAY- 


80 


08M9 


PROG.FTN5 1 


6. 




14 


-AUG- 


81 


08:35 


PROG . OBJ » 1 


0. 




14 


-AUG- 


81 


08 J 36 


PROG. LST? 1 


0. 




14 


-AUG- 


81 


08 : 36 


PROG . OBJ » 2 


5 . 




14 


-AUG- 


81 


08 : 36 


PRQG.LSTJ 2 


11 ♦ 




14 


-AUG- 


•81 


08 : 36 


PROG . FTN i 2 


6. 




14 


-AUG- 


81 


08J36 


PROG ♦ FTN i 3 


6. 




14 


-AUG- 


•81 


08:37 


PROG.TSK i 1 


6 » 


c 


14 


-AUG- 


81 


08 : 37 


MACIO . MAC i 5 


3. 




04 


-AUG- 


81 


09: 14 


MACIO ♦ OB J > 5 


1 ♦ 




14 


-AUG- 


81 


10:46 


MACIO ♦ LST i 1 


5 . 




14 


-AUG- 


81 


10 : 46 


DIRECTORY ♦ LST J 1 


3. 




18 


-AUG- 


81 


16:28 


XYZ.MACJ1 


3. 




19 


-AUG- 


81 


09:43 


XYZ.TSKJ 1 


4. 


c 


19 


-AUG- 


81 


09:43 


VIP. OBJ? 3 


1 . 




19 


-AUG- 


81 


09M6 


VIP ♦ MAC i 5 


3. 




19 


-AUG- 


81 


09M6 


VIP,0BJ?4 


1 . 




19 


-AUG- 


81 


09: 47 


VIP.0BJJ5 


1 . 




19' 


-AUG- 


81 


09M7 


VIP.LST?5 


5 , 




1 o 

1 7 


-AUG- 


81 


AO* A "7 


MACIO ♦ MAC i 7 


3. 




19 


-AUG- 


81 


09M8 


MACIO « MAC i 6 


3. 




19 


-AUG- 


81 


09:48 


MACIO. MAC? 10 


3. 




19- 


-AUG- 


81 


09M9 


PRIMES ♦ TSK ? 1 


46. 


c 


19 


-AUG- 


81 


13:57 


Total of 193. /199. 


bl ocks 


in : 


28. 


f i les 




>SET DEFAULT E305y 


304] 












>DIR 














Directory DK2 ♦ C305 r 3043 












15-DEC-81 11J40 














LOGIN . CMD i 1 


1 . 




04 


- AUG- 


81 


08:43 


L0G0UT.CMDJ5 


1 . 




23 


-MAY- 


80 


08M9 


STARTUP ♦ CMD i 57 


14. 




06 


-JUL- 


81 


10:53 


PRIMES ♦ MAC i 43 


8. 




15 


- JAN- 


81 


16 : is 


ADVENTURE . TSK i 1 


151 . 


C 


05 


-AUG- 


81 


16J29 


CLAMBAKE ♦ TXT i 1 


3. 




05 


-AUG- 


81 


16 : 18 


NOTICE.TXTil 


14. 




16 


-MAR- 


81 


10:34 


PRIMES.OBJi 1 


o 




14 


-AUG- 


81 


11 :o9 


PRIMES ♦ LST i 1 


13. 




14 


-AUG- 


81 


11 J09 


PRIMES > TSK f 1 


46, 


C 


14 


-AUG- 


81 


11 :09 


PRIMES.MAPJ1 


3. 




14 


-AUG- 


81 


11 :o9 


A ♦ MAC i 2 


3. 




18 


-AUG- 


81 


16.30 


VIP . TSK * 1 


4. 


C 


19' 


-AUG- 


81 


13:58 


PROG , TSK i 1 


6. 


C 


18 


-AUG- 


81 


i6:3i 


Totsl of 269./273. 


blocks 


in 


14. 


f i les 





Example 4-1 How the Default UFD Works 
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Table 4-1 Special User File Directories 
User Wants to Find Look On 

General System Files - Macro, System, 

FCS, Memory Management Libraries LB: [1,1] 

Help files and command files - Startup 
and Shutup Command Files, Login .TXT, MCR, 

DCL, Utility Help Files LB: [1,2] 

BATCH, PRINT Queues, Spooling Files LB: [1,7] 

Operating System Images (M and M-PLUS) SY:[1,54] 
Files associated with the Introduction 

to RSX-11M Manual [200,1] 
Nonpr ivileged System Utility Programs 

(M systems) SY: [1, 54] 

Nonpr ivileged System Utility Programs 

(M-PLUS only) SY: [6,54] 



LEARNING ACTIVITY 

1. READ Sections 4.1 through 4.1.4, in 
Chapter 4 of the RSX-11M/M-PLUS Command 
Language Manual. 
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MAINTAINING A USER FILE DIRECTORY 

When your terminal session activity has been heavy, your UFD 
may contain unnecessary files. You may want copies of files from 
someone else's UFD, or to copy some of yours to another UFD. 
Although there is no limit to the number of files you may have in 
your UFD, there is a physical limit to the number of files that 
can exist on a volume. Therefore, some file maintenance must be 
performed to ensure that unneeded files are removed to free up 
disk space for everyone's use. Table 4-2 lists some of the DCL 
file maintenance commands that will maintain your UFD and other 
UFDs. The DCL command line is reviewed below. 

Command Formats 

> DIR / FULL S AMPL EPTN;3, Other .FTN <RET> 
ooeo e o © e 

>COPY [305,301]VIP.TSK [305,303]yiP.TSK <RET 
o o o o o o 

>RENAME<RET> 
Old file name? SAMPLE.FIL <RET> 
New file name? NEW. TXT <RET> 



o 


DCL command name 


e 


e 


qualifier delimiter 


e 


e 


command qualifier 


o 


o 


command delimiter 


o 


e 


file specification 





file specification list delimite 
input file specification 
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Table 4-2 File Maintenance Commands 



User Wants To 

List the files in a User File Directory 

Delete files from a User File Directory 

Delete all versions except the latest 
version of a file 

Copy a file within a UFD or between UFDs 

Append one file to another 

Change the name of a file 

Display the contents of a file at 
the terminal 

Print a copy of a file on a line printer 
Merge 



Command To 
Use 

DIRECTORY 
DELETE 

PURGE 
COPY 
COPY 
RENAME 

TYPE 

PRINT 

CONVERT 
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Defaults in File Specification 

Defaults allow you to specify files without having to type in 
the full specification. Shown below is an example of using 
defaults to your advantage. The results of issuing the DIR 
command are shown in Example 4-2. Refer to Table 4-3 for the 
rules governing the use of defaults in a file specification. 



Command Format 




o e e o 

^ ^_ / 

e 



The first file specification is explicit on all fields. 

Q The file type is implied, and the default taken. The default 
file type is .MAC from the previous file specification. The 
version number is implied; the default is always the latest 
version no matter what the previous file specification states. 

Q The file name is implied, and the default taken. The default 
file name is MACIO from the previous file specification. 

Q The file name and type are implied from the previous file 
specification. Therefore, this file specification equates to 
MACIO. TSK;4. 

Q In all cases the device and UFD are implied, the default being 
the user's default device and UFD. 
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Table 4-3 Defaults in a File Specification 



Field 

Device 

UFD 

File name 

File type 
Version 



First File Spec 
in Command 



SY: 



Default 
UFD 

None 



None 

Highest version 



>DIR VIP,MACJ3»MACI0r .TSK 



Directory DK2 * C305 1 303 D 
15-DEC-81 11146 



VIP . MAC i 3 
MACI0«MAC? 10 
MACI0.TSKJ5 
MACIO.TSKM 



3. 
3. 
4. 
4, 



19-AUG-81 09J46 

19-AUG-81 09549 

15-DEC-81 11 M3 

15-DEC-31 11543 



Next File 
Spec 

Last device 
specified 

Last UFD 
specified 

Previous file 
spec 

Last type 
specified 

Highest version 



Total of 14. /18. blocks in 4. files 



Example 4-2 Using Defaults in a File Specification 



191 



FILE AND DIRECTORY MAINTENANCE 



Listing Directories 

When you wish to list the files that are in your directory, 
use the DIRECTORY command. It is also used to list files in other 
directories, to list a particular group of files (such as all 
MACRO source files) , to search a group of directories for a 
particular file, to determine the amount of free space on a 
device, and to determine the amount of space used by files in a 
UFD. Example 4-3 shows the results of issuing the directory 
commands in the examples. Refer to the notes for an explanation 
of the results. 

Command Format 

>DIR 

>DIR VIP.MAC 
>DIR/FULL PAYROLL.CBL 
>DIR [305,304] 
>DIR/BRIEF 
>DIR/SUMMARY 
>DIR/PRINT 

>DIR/OUTPUT:DIRECTORY.LST 
>DIR/FREE DBO 
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>DIR 

Directory DK2 J C305 1 303D 



X J L'bw OX i i > WW 














A 


w 










1 * 






HUu 


D X 


ftft ♦ At 


UTp, T^K • 1 
Y x r . I w i\ r x 


4 1 




14 


-AUG- 


'81 


10*48 


PAYK'fll 1 -PHI • 1 


2 , 




V o 


- JAN- 


81 


15*31 


TNFf) » TXT • 1 

x rt r w ♦ IAI FX 


60 ♦ 




07 


- JUI_- 


80 


12 5 47 


LUwUU 1 4 V rl X' F W 


1 # 




28' 


— M A Y — 


80 


08 5 49 


PRflR x FTM i 1 
r i\uu ♦ r i n f x 


o * 




1 4 


nUu 


O X 


08 5 35 


ppnf! np i: 1 

r IMJU lUDJf 1 


ft 




1 4< 
X H 


- Al IR- 

H WW 


R 1 
O X 


fiR fX A 
vD ♦ wO 


PpftR 1 CT i 1 


A 

V 4 




1 4 
X *t 


HUu 


• P. 1 

O X 


ftfl t 7 A 




ij 4 




x *t 




•ft 1 

W X 


f)ft ! TEA 


rf\WW4L.WI 1 £. 


1 1 4 




14 


-AUG- 


•81 


08 5 36 


r r\ u u * r i n t a 


o * 




x *t 


_ A| |fl_ 
nUU 


■R 1 
D X 


AO ♦ -I z 

4 WW 


P O n R CTWil 
r KUU > r mfil 


z 

o ♦ 


A 
w 


1 A 


HUu 


.01 

a l 


U6 4 0/ 


r IVUu * 1 DIN f 1 


A - 


r 
w 


1 4' 

X *t 


MU w 


R1 

O X 


V O 4 O / 


MAC 10 ♦ MAC f 5 


3 ♦ 




04 


-AUG- 


•81 


09 5 14 


MACI0.0BJJ5 


1 . 




14 


-AUG- 


81 


10546 


MACIO.LSTfl 


5, 




14 


-AUG- 


81 


10M6 


DIRECTORY . LST i 1 


3. 




18 


-AUG- 


81 


16528 


XYZ.MACrl 


3. 




1? 


-AUG- 


•81 


09543 


XYZ.TSKil 


4. 


c 


19 


-AUG- 


•81 


09543 


VIP«0BJr 3 


1. 




19 


-AUG- 


81 


09546 


VIP«MAC»5 


3. 




19 


-AUG- 


•81 


09546 


VIP.0BJJ4 


1. 




19 


-AUG- 


•81 


09 5 47 


VIP40BJ>5 


1 . 




19 


-AUG- 


81 


09547 


VIP ♦ LST » 5 


5. 




19 


-AUG- 


•81 


09 5 47 


MACI0«MAC>7 


3. 




19' 


-AUG- 


81 


09548 


MACI0*MAC»6 


3. 




19 


-AUG- 


•81 


09548 


MACIO.MACf 10 


3. 




19 


-AUG- 


81 


09549 


primes.tsk; i 


46. 


C 


19 


-AUG- 


•81 


13557 



Total of 193. /199. blocks in 28, files 



>DIR VI P. MAC?* 



Directory DK2 5 C 305 t 3033 
15-DEC-81 11545 



VIP .MAC? 5 3. 19-AUG-81 09546 

Total of 3./5. blocks in 1. file 



© >DIR/FULL PAYROLL * CBL 



Directory DK2 5 C305 1 303 J 
15-DEC-81 11547 

© 

PAYROLL ♦ CBL i 1 (17»2) 2./2. 08-JAN-81 1U531 

C305*303]CRWEDtRUED»RUED»R] 14-AUG-81 10551(10.) 

o 

Total of 2./2. blocks in 1. file 
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© 



Directory DK2 5 C 305 > 3043 
15-DEC-81 11J48 



LOGIN . CMD i 1 
LOGOUT > CMD i 5 



1 . 
1* 
14. 

8. 



04-AUG-81 08M3 

28-MAY-80 08149 

06-JUL-81 10:53 

15-JAN-81 16515 



STARTUP ♦ CMD » 57 
PRIMES ♦ MAC ? 43 
ADVENTURE ♦ TSK > 1 
CLAMBAKE ♦ TXT i 1 



3. 
14. 



151 ♦ 



C 05-AUG-81 16J29 

05-AUG-81 16:18 

16-MAR-81 10:34 

14-AUG-81 li:09 

14-AUG-81 li:09 



NOTICE .TXT i 1 
PRIMES.OBJi 1 
PRIMES.LSTJ 1 
PRIMES ♦ TSK r 1 
PRIMES.MAPJ 1 
A . MAC 1 2 



13. 

46. 

3. 

3. 

4. 

6. 



C 14-AUG-81 li:09 
14-AUG-81 li:09 
18-AUG-81 16J30 



VIP.TSKJ 1 
PROG . TSK i 1 



C 13-AUG-81 16:31 



C 19-AUG-81 13:58 



Total of 269. /273. blocks in 14. files 



Q >DIR/BRIEF 



Directory DK2 : C305> 3033 

LOGIN . CMD i 1 
MACIO ♦ TSK f 5 
MACIO.TSK? 4 
VIP ♦ MAC i 3 
VIP.TSKi 1 
PAYROLL . CBL i 1 
INFO. TXT? 1 
LOGOUT ♦ CMD t 5 
PROG ♦ FTN t 1 
PROG . OBJ i 1 
PROG.LST* 1 
PROG . OBJ i 2 
PR0G,LST»2 
PR0G.FTN?2 
PROG ♦ FTN i 3 
PROG. TSK ; 1 
MAC I O.MAC? 5 
MACIO . OBJ t 5 
MACIO.LSTf 1 
DIRECTORY ♦ LST f 1 
XYZ.MAC? 1 
XYZ.TSKi 1 
VIP.0BJJ3 
VIP ♦ OB J > 4 
VIP. OBJ? 5 
VIP . LST > 5 
MACIO.MAC57 
MACIO . MAC ? 6 
MACIO.MACf 10 
PRIMES ♦ TSK ? 1 
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Q > D I R / S U M M A R Y 



Storage used/3l located for Directory DK2 » C305 > 3033 
15-DEC-81 11M8 



Total of 201. /207. blocks in 30. files 



>DIR/ OUTPUT i DIRECTORY .LST 
>DIR DIRECTORY, LST 



Directory DK2 5 [ 305 > 3033 
15-DEC-81 11 549 

DIRECTORY. LSTJ2 4. 15-DEC-81 11549 

Total of 4./4. blocks in 1» Tile 

> D I R / F R E E 

DK2J has 4091. blocks free* 709. blocks used out of 4800. 
Largest contiguous s^ace - 2242. blocks 

239. file headers are f ree» 55. headers used out of 294. 



>DIR/FREE DB 1 I 

DBi: has 55407. blocks free* 285263. blocks used out of 340670. 
Largest contiguous space = 33634. blocks 

13885. file headers are freer 11708. headers used out of 25593. 
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Notes on Example 4-3 

Q Command to obtain a listing of files in the user's default 
device and UFD. 

Q Device, UFD for which the directory, day, and time are 
given • 

Q File name, type and version. 

Size of the file in blocks (decimal). 

Q Creation date. 

Q Creation time. 

C indicates file stored contiguously on the disk. L 
indicates file is locked (not properly closed). You will 
not be able to read this file. 

Q Summary including the number of blocks used, the number of 
blocks allocated, and the number of files. 

Q Directory on a specific file. 

Q Example of full directory. 

Q File ID. 

Q Owner of the file. 

® Protection setting. 

© Obtaining a directory of another UFD. 

® Obtaining a quick directory of the user's UFD. 

^ Obtaining only summary information. 

O Putting the directory information into a file. 

® Obtaining information on the volume. 
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Deleting Files 

When you wish to remove a file from your UFD, you may do so 
by using the DELETE command. Care must be taken to ensure that 
the correct file specification has been supplied or you may delete 
a needed file. If a file is deleted by mistake, it may be 
possible to recover that file from the system backup tapes and 
disks. This depends upon when and if your system manager has 
performed a backup. Backing up a volume is copying its files to 
another disk, or to a magnetic tape for security purposes. The 
DELETE command allows you to selectively delete files from a UFD 
(as shown in the fourth command example below) and also to provide 
a log of the files that have been deleted (third command example) . 

Example 4-4 provides some samples of the DELETE command. 



Command Format 







■* 
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>DIR MACIO * TSK ? * 



Directory DK2 I C305 1 3033 
15-DEC -81 11551 



MACI0.TSKJ5 


4. 




C 


15-DEC- 


81 


11 M3 


MACIO. TSK>4 


4. 




C 


ij-uEC" 


y i 


4 4 « A "> 

1 1 . 4o 


MACIO.TSKJ 1 


4. 




C 


15-DEC- 


81 


11 .50 


MACI0.TSKJ3 


4. 




c 


15-DEC- 


81 


ii :so 


MACI0.TSK52 


4. 




c 


15-DEC- 


81 


11 J50 


Total of 20. /20, 


blocks 


in 


5. 


f iles 






>DEL/L0G MACIO. T 


SKr* 












The following files have been 


deleted! 






DK2:C305»303DMACI0.TSKf 


5 










DK2:C305»303 3MACI0.TSKJ 


4 










DK2:C305»3033«ACI0.TSK? 


1 










DK2:C305>303 3MACI0.TSK; 


3 










DK2JC305f 303DMACI0.TSK? 


2 










>DIR MACIO**?* 














Directory DK2 J £305 r 3033 












15-DEC-81 11!52 














MACI0.MACJ5 


3. 






04-AUG- 


81 


09:14 


MACIO. 0BJJ5 


1 . 






14-AUG- 


81 


10J46 


MACIO. LSTil 


5. 






14-AUG- 


81 


10J46 


MACIO. MACr 7 


3. 






19-AUG- 


81 


09:43 


MACI ♦ MAC t 6 


3. 






19-AUG- 


81 


09M8 


MACIQ.MACf 10 


3, 






19-AUG- 


81 


09J49 


Totsl of 18. /22. 


blocks 


in 


6. 


f i les 







>DEL *.LST5* 
>DIR *.LSTJ* 
DIR — No such file(s) 



Example 4-4 DELETE Command Samples 
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Purging Old Files 

To ensure that at least one version of a file is always 
retained in your UFD after deleting files, use the PURGE command. 
This command offers the option to save a variable number of 
versions of a file. This ability is especially useful after a 
series of editing sessions, to clean up unwanted files. It is 
also useful to purge all files in your UFD at the end of the day. 
This frees up storage space on the volume and makes it available 
for all to use. 

Example 4-5 shows how to purge files. 



Command Format 



>PURGE VIP.MAC 
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>DIR VIP * MAC i* 



Directory DK2 J C305 » 3033 
15-DEC-81 11554 



O 



VIP. MAC? 1 


3. 




15-DEC- 


81 


11 J53 


VIP » MAC J 2 


3* 




15-DEC- 


81 


11 153 


VIP ♦ MAC J 3 


3. 




19-AUG- 


81 


09M6 


VIP.MACM 


3. 




15-DEC- 


81 


11 J53 


VIP ♦ MAC > 5 


3. 




15-DEC- 


81 


11 :53 


Total of 15./17* 


blocks 


in 5 . 


f iles 






>PUR6E VIP ► MAC 












>DIR VIP » MAC r * 












Directory DK2J C305»303D 










15-DEC-81 11:58 












VIP.MACJ5 


3. 




15-DEC- 


81 


11 553 


Total of Zt/S* blocks in 


1. file 






>DIR VIP.LSTJ* 












Directory DK2:C30 


5»303D 










15-DEC-81 12501 












VIP.LSTil 


5. 




15-DEC- 


81 


11 J59 


VIP .LST i 2 


5. 




15-DEC- 


81 


11 J59 


VIP .LSTJ 3 


5. 




15-DEC- 


61 


12J00 


VIP.LSTM 


5. 




15-DEC- 


81 


12:00 


VIP.LSTJ5 


5 « 




15-DEC- 


81 


12:00 


Total of 25«/25. 


blocks 


in 5. 


f iles 






>pur3e/losi vip.ls 


t 










The following files have 


been 


deleted ♦ 







DK2:C305f3033VIP,LST; 1 
DK2:C305>3033VIP.LST?2 
DK2:C305»303DVIP.LST>3 
DK2:C305»3033VIP.LSTJ4 



Example 4-5 Purging Files (Sheet 1 of 
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> d i r v i p ♦ o b J i * 



o 



Directory DK2J C305f 303D 
15-DEC-81 12502 



VIP. OBJ 
VIP . OBJ 
VIP.OBJ 
VIP. OBJ 
VIP. OBJ 
VIP.OBJ 
VIP. OBJ 
VIP. OBJ 
VIP. OBJ 
VIP.OBJ 



6 
7 

10 

11 

12 

13 

14 

3 

4 



15 
15 
15 
15 
15 
15 
15 
1? 
19 
19 



DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
DEC 
AUG 
AUG 
AUG 



81 
81 
81 
81 
61 
81 
81 
81 
81 
81 



1U59 
11J59 
1 1 J 59 
11 J59 
12100 
12J00 
12:00 
09546 
09*. 47 
09M7 



Total of 10. /10. blocks in 10. files 



>pursie/keep I 3 vip»obJ 
> d i r v i p ♦ o b J 5 * 



Directory DK2. £305*3033 
15-DEC-81 12:02 

VIP.0BJJ12 1. 15-DEC-81 12:00 

VIP.0BJJ13 1. 15-DEC-81 12:00 

VIP.0BJJ14 1. 15-DEC-81 12:00 

Total of 3./3. blocks in 3. files 



Notes on Example 4-5 

Directory of VIP. MAC before and after using the purge 
command. The latest version is retained. 

Q Example using /LOG qualifier on the purge command to 
report deleted files. 

Q Example using the /KEEP qualifier of the purge command, 
which in this case retained the latest three versions of 
file VIP.OBJ. 



Example 4-5 Purging Files 



(Sheet 



2 of 2) 
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Copying Files 

The COPY command is used to make a copy of a file. In 
addition to creating a copy, the command makes the necessary 
entries into the directory structure so that the file can be 
located at a future time. The command can be used to copy files 
within a UFD, between UFDs on the same device, and between 
devices. It is also used to merge multiple files into one file. 

Command Format 

>COPY VIP.MAC [305,304]VIP.MAC 

>COPY VIP.TSK,PROGTSK [305,304]*.* 

>C0PY 
From? VIP.MAC 
To? [305,304]*.* 

>eopy vip.msc 1 305 ? 304 1 v i p , mac 



>dir C305 ? 304!] vip . mac 

Directory DK2 * C305 » 3043 
15-DEC-81 12J03 

VIP.MACil 3. 15-DEC-81 12J03 

Total of 3,/3» blocks in 1> file 



>copy 

From? vip.tsk?pro2>tsk 
To? C305t3043*.« 



Example 4-6 COPY Command 
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Renaming Files 

The RENAME command is used to change the name, type or 
version of a file. It does not make a new copy of the file; it 
simple alters the directory entry. 



Command Format 



>RENAME 



A.MAC B.MAC 



>RENAME 



A.MAC A.MAC;2 



>RENAME 



A.* B.* 



>RENAME VIP* MAC A.MAC 
>D I R 



Directory DK2 ♦ C305 » 304D 
15-DEC-81 12 5 08 



LOGIN. CMDJ1 
LOGOUT ♦ CMC ) 5 
STARTUP. CMDJ57 
PRIMES . MAC i 43 
ADVENTURE. TSKJl 
CLAMBAKE ♦ TXT i 1 
NOTICE ♦ TXT ? 1 
PRIMES. OBJJl 
PRIMES.LSTJ1 
PRIMES . TSK i 1 
PRIMES . MAP i 1 
A . MAC i 1 
VIP.TSK* 1 
PROG.TSKJ 1 
VIP . TSK i 2 
PROG. TSK i 2 



13. 

46. 

3. 

3. 

4. 

6. 

4. 

6. 



1 . 
1 . 
14. 
8. 



3. 
14. 



7 



151 . 



C 
C 
C 
C 



C 



C 



04- AUG-81 
28-MAY-80 
06-JUL-81 

15- JAN-81 

05- AUG-81 
05-AUG-81 

16- MAR-81 
14-AUG-81 
14-AUG-81 
14-AUG-81 

14- AUG-81 

15- DEC-81 
19-AUG-81 
18-AUG-81 
15-DEC-81 
15-DEC-81 



08543 
08549 
10553 
16515 
16529 
16518 
10534 
11 509 
11 509 
11 509 
11 509 
12503 
13558 
16531 
12504 
125 04 



Total of 279. /283. blocks in 16. files 
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>RENAME A.MAC A . MAC ? 2 
>DIR 



Directory DK2. [305*3043 
15-DEC-81 12J08 



LOGIN.CMDJ 1 


1 . 




04- 


AUG- 


81 


08 543 


LOGOUT . CMD i 5 


1. 




28- 


MAY- 


80 


08M9 


STARTUP.CMD i 57 


14. 




06- 


JUL- 


81 


10553 


PRIMES. MACJ43 


8. 




15- 


JAN- 


81 


16:15 


ADVENTURE ♦ TSK i 1 


151 . 


C 


05- 


AUG- 


81 


16529 


CLAMBAKE. TXTJ1 


3. 




05- 


AUG- 


81 


16: is 


NOTICE ♦ TXT f 1 


14. 




16- 


MAR- 


81 


10:34 


PRIMES. 0BJJ1 


2. 




14- 


AU6- 


81 


11 :09 


PRIMES.LSTJ 1 


13. 




14- 


AUG- 


81 


11 :09 


PRIMES . TSK i 1 


46. 


C 


14- 


AUG- 


81 


11 :o9 


PRIMES . MAP 1 1 


3 . 




14- 


AUG- 


81 


11:09 


A. MAC; 2 


3. 




15- 


DEC- 


81 


12:03 


VIP. TSK > 1 


4 . 


c 


19- 


AUG- 


81 


13:58 


PROG. TSK > 1 


6. 


c 


18- 


AUG- 


81 


16:31 


VIP. TSK } 2 


4. 


c 


15- 


DEC- 


81 


12:04 


PR0G.TSKJ2 


6 . 


c 


15- 


DEC- 


81 


12 : 04 


Total of 279. /283. I 


blocks 


in : 


16. files 




> RENAME VIP.*»* A.* 


it 












>DIR A.*»* 














Directory DK2:C305> 


3033 












15-DEC-81 12t06 














A.MACJ5 


3. 




15- 


-DEC- 


-81 


11 :53 


A.TSKrl 


4. 


c 


14- 


-AU6- 


-81 


10M8 


A.0BJ»12 


1 . 




15- 


-DEC- 


-81 


12:00 


A.OBJ'f 13 


1. 




15- 


-DEC- 


-81 


12:00 


a.obj; 14 


1. 




15- 


-DEC- 


-81 


12:00 


A.LST»5 


5 . 




15- 


-DEC- 


-81 


12:00 



Total of 15./15. blocks in 6. files 



Example 4-7 Renaming Files (Sheet 2 of 
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INSPECTING THE CONTENTS OF FILES 



The contents of a file can either be displayed on your 
terminal (hard-copy or CRT) or sent to a line printer for fast 
hard-copy output. Only ASCII files should be displayed or 
printed. Other files such as object files and task image files 
are in a format understood only by a machine. Displaying them at 
your terminal or on the printer produces undesirable results. 



Displaying File Contents at Your Terminal 

You will frequently want to inspect the contents of a file 
quickly without using an editor. This is done by issuing the TYPE 
command. The contents of the file are then displayed at the 
receiving speed of your terminal. When using a CRT, it is useful 
to use the Scroll key or <CTRL/S> and <CTRL/Q> to aid in reading 
the data. Typing a non-ASCII file, such as an object file or a 
task image file, to a CRT produces undesirable results. It is 
also possible that the combinations of characters created by the 
interpretation of non-ASCII data will cause certain terminal 
features, like holdscreen, to be set. In the case of hard-copy 
terminals, the interpretation of non-ASCII data may cause form 
ejects and line feeds to spew paper behind the terminal. 



Command Format 



>TYPE 




>TYPE 



DK1 :[305,303]MACIO.MAC 



>TYPE 




>TYPE 
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>TYPE NEW , TXT 

TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU ♦ TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE ♦ 

ALL'S WELL THAT ENDS ♦ 

UNDER THE MOST RIGOROUSLY CONTROLLED CONITIONS OF PRESSURE 
TEMPERATURE t VOLUME, HUMIDITY, AND OTHER VARIABLES THE 
ORGANISM WILL DO AS IT DARN WELL PLEASES ♦ 
ANY GIVEN PROGRAM t WHEN RUNNING IS OBSOLETE ♦ 

THE DEGREE OF TECHNICAL COMPETENCE IS INVERSELY PROPORTIONAL 
TO THE LEVEL OF MANAGEMENT ♦ 

TELL A MAN THERE ARE 300 BILLION STARS IN THE UNIVERSE 
AND HE'LL BELIEVE YOU* TELL HIM A BENCH HAS WET PAINT 
ON IT AND HE'LL HAVE TO TOUCH IT TO BE SURE. 



Example 4-8 Using the TYPE Command 
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Displaying Files on a Line Printer 

To obtain a hard copy of a text file on the line printer, 
issue the PRINT command in one of the formats shown below. An 
entry will be placed in a list managed by a task called the Queue 
Manager, and when the printer is available the file will print. 
This command has many qualifiers that enhance its use. For 
printing more than one copy at a time, the /COPIESrn qualifier is 
used. If special forms are needed when the job is printed, that 
requirement is indicated by using the /FORMs:n qualifier. n is a 
number and specifies the type of form . The correlation between 
the number and type of form is a site consideration that varies 
from location to location. The first page that is printed on a 
print job is called the job flag-page and contains information 
regarding the job, i.e., the file name, the date and time of 
printing. Before each file is a file flag-page, giving 
information about the file. When printing multiple files with one 
print command, there will be one job flag-page and no file flag- 
pages printed. 

Command Format 

>PRINT VIP.MAC 
>PRINT/C0PIES:2 INFO.TXT 
>PRINT/FLAG_PAGE INF0.TXT,VIP.MAC/C0:2 
>PRINT/PRIORITY:100 VIP.MAC 
>PRINT/DELETE INFO.TXT 
>PRINT/F0RMS:1 PROG.LST 
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PRINT Command Defaults 

/NO DELETE 
/COPIES: 1 
/FORMS : 
/PRIORITY: 50. 
/N OF LAG PAGE 



LEARNING ACTIVITIES 

1. READ the sections on the following 
commands in Chapter 4 of the 
RSX-11M/M-PLU Command Language Manual . 

• Directory 

• Delete 

• Purge 

• Copy 

• Type 

• Print 
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PROTECTING YOUR FILES 

In a multiuser system, it is advantageous to be able to 
protect files from being deleted or corrupted by unknowing users, 
and to provide data security when it is necessary. In the 
RSX-11M/M-PLUS FILES-11 system, this is provided through two file 
attributes; file ownership and file access rights. Every file 
has stored with it the owner of the file and the access privileges 
that have been granted to the owner and other users of the system. 
In addition, access rights can be established on a UFD and on a 
volume. To be able to access a file, a user must meet the 
conditions at all three levels. 

File Ownership 

Every file has stored with it the UIC of the user who created 
the file. (Refer to item 12 in Example 4-3 to review how to 
obtain this information.) In item 1 in Example 4-9, the person 
who owns the UFD is also the owner of the file PAYROLL. CBL located 
in that UFD. When a user or a task attempts to access the file, 
the UIC of the requesting user or task is compared with that of 
the owner of the file and access is granted or denied depending 
upon that relationship. The owner of a file does not always 
coincide with the owner of the UFD in which the file resides, as 
in item 2 of Example 4-9. 

Figure 4-4 illustrates the transfer of file ownership. 



> DIR/FULL PAYROLL, CBL 



Directory DK2t C305> 303] 
15-DEC-81 11J47 

A PAYROLL ♦ CBL * 1 <17»2> 2./2. 08-JAN-81 15J31 

C 305 r 303 1 C RUED r RUED r RUED rR] 14-AUG-81 10:51(10.) 

Total of 2./2» blocks in 1« file 

>DIR [305*3043 



> 

> DIR/FULL EX2D4T.LST 



Directory DR0 JC305»303D 
15-0CT-81 16t0? 

EX2D4T»LST»4 (3734*150) 8»/8. 15-0CT-B1 16t08 

C7»3053 C RUED > RUED r RUED rR] 

Total of 8./8. blocks in 1* file 



Example 4-9 File Ownership 
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>COPY A.TSK [305,306] A.TSK 
FROM 



TO 



J305,3031^ 



A.TSK 

OWNER: 
[305,303] 



[305,306] 



A.TSK 

OWNER: 

[305,303] 



USER [305,303] COPIES FILE TO [305,306] 



(OWNER 
STAYS SAME) 



XX)PY [305,306] B.MAC 
TO 

(C33p5,303T^I 



FROM 



B.MAC 

OWNER: 

[305,303] 



jCT[305,306] 



B.MAC 

OWNER: 

[305,306] 



Q USER [305,303] COPIES B.MAC FROM [305,306] 



TO HIS OWN UFD. 



>COPY/OWN A.TSK [305,306] A.TSK 
FROM 



TO 



.[305,303], 



A.TSK 

OWNER: 

[305,303] 



[305,306] 



A.TSK 

OWNER: 

[305,306] 



USER [305,303] COPIES A.TSK TO [305,306] 
MAKING THE OWNER [305,306] 



Figure 4-4 Transferring File Ownership 
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When a user copies a file from his UFD to another UFD, he 
maintains ownership of the file and his UIC will be stored with 
the file. In Figure 4-4, at item 1, user [305,303] copies the 
file A.TSK to UFD [305,306] and remains the owner of file. The 
owner of UFD [305,306] may or may not have access to that file, 
depending upon what protection rights the owner of the file has 
given to members of the same group. When a user copies a file 
from another UFD, the user becomes the owner of the file as shown 
in item 2 of the figure. If the user wishes to transfer file 
ownership to the UFD to which it is being copied, the /OWN 
qualifier should be used, as shown in item 3. 



>COPY VIP. TSK C305,304]VIP.TSK 



>DIR/FULL C305r304]VIP.TSK 



Directory DK2 { C305 r 304] 
15-DEC-81 12:22 



VIP. TSK, 1 <14,5> 
C305 » 303] C RUED, RWED » RWED r R] 

Total of 7./7. blocks in 1, file 



7./7 



C 15-DEC-81 12:21 



>C0PY £305, 304] PRIMES .TSK 11305*303] 
>DIR/FULL PRIMES .TSK 



Directory DK2 : C305, 303] 
15-DEC-81 12:22 

PRIMES. TSKJ2 (16,5) 
£305 , 303] C RUED » R WED r RUED » R] 

Total of 46. /46, blocks in 1, file 



46. /46. 



C 15-DEC-81 12:22 



>C0PY/0WN VIP. TSK C305 , 304 ] VI P . TSK 



>DIR/FULL C305»304]VIP.TSK 



Directory DK2 : C305 1 304] 
15-DEC-81 12:23 



VIP.TSKJl <14»6) 
C305 t 304] CRWEDf RUED ? RUED »R] 



7./7. 



15-DEC-81 12:23 



Total of 7./7. blocks in 1. file 



Example 4-10 Transferring File Ownership Samples 
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File Access Rights 

There are four groups of users, as shown in Table 4-4. The 

owner is the user whose UIC is saved with the file. Each one of 

these groups can be awarded up to four different types of access, 

as listed in Table 4-5. If the user has not specified a 

protection, the system will assign the default file protection 
shown in Table 4-6. 



Table 4-4 Groups of Users 



[305,303] 
Group 

[305,306] 
[305,301] 
[305,303] 



Owner's UIC 



Same UIC group 
as owner 



System 

[5,6] 
[7,2] 
[10,300] 



Special UIC group 
Group # <= 108 
Privileged User 



World 

[307,5] 

[322,323] 

[200,20] 



All others 



Access Right 
READ 

WRITE 

EXTEND 

DELETE 



Table 4-5 Access Rights 

Operations That Can be Performed 
Copy, Print, Type Directory, Run 

Includes READ rights and may alter 

Includes READ, WRITE rights plus the 
ability to extend space allocated to 

Includes all rights above plus the 
ability to delete 
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Default File Protection 

Table 4-6 Default File Protection 
SY:RWED OWtRWED GRrRWED WO:R 
System Read, Write, Extend, Delete 

Owner Read, Write, Extend, Delete 

Group Read, Write, Extend, Delete 
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Setting and Changing File Protection 

The user may change the protection on any file that he owns, 
no matter where it resides, by using the SET PROTECTION command. 
However, another user who is a member of the user's group or world 
may not change the protection on the user's file even if he has 
read, write, extend and delete privileges. A privileged user may 
change the protection on any file. The format of the command is 
shown below. An example of issuing the command is shown in 
Example 4-11. 



Command Format 

>SET PROTECTION 
File? INFO.TXT 

Code? (SY:RWED,OW:RWED,GR:RWED,WO:F 



>DIR/FULL INFO.TXT 



Directory DK2 I E305 , 3033 
15-DEC-81 12J23 

INF0.TXTJ1 (20>2) 60. /60. 07-JUL-80 12M7 

C305f 303KR»R> f 1 14-AUG-81 10154(11.) 

Total of 60./60. blocks in 1. file 



>SET PROTECTION 
File? INFO.TXT 

code? <sy:r,ow:rwed,gr:r»wo; ) 

>DIR/FULL INFO.TXT 



Directory DK2 5 C305 1 303D 
15-DEC-81 12t24 

INFO.TXTil (20,2) 60. /60. 07-JUL-80 12547 

C305f3033CR»RWEDrR»3 14-AUG-81 10:54(11.) 

Total of 60. /60. blocks in 1. file 



Example 4-11 Setting File Protection 
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Figure 4-5 shows the accessibility of each group of users to 
the files located in the UFD [305,303]. It is understood that 
[305,303] is the owner of all the files located there. A member 
of the group [305, xxx] would not be able to type the file 
[ 305, 303] VIP. MAC, because the owner of the file has not given 
members of his group read privileges, which you must have to type 
a file. The owner is the only one who can access this file, as no 
privileges have been given to any other group. Do not be misled 
into thinking that a privileged user is not able to access this 
file. A privileged user may change the protection on any file. 
This is important to remember: if you should issue the SET 
PROTECTION command, you can take away all rights to every group, 
including yourself. 



Equivalent MCR Commands 

Table 4-7 gives the equivalent MCR commands for the file 
maintenance operations discussed in this module. The utility 
task, PIP, performs the file maintenance tasks. Documentation for 
PIP is found in the RSX-11M/M-PLUS Utilities Manual. 



215 



FILE AND DIRECTORY MAINTENANCE 



[305,303] 



VIP.MAC 
VIP.LST 



_ VIP.TSK 
PROG.FTN 



_ PA Y R O L L.TSK ^ 
LOGIN.CMD 



PROT = SY:,OW:RWE,GR:,WO: 



PROT=SY:RWE,OW:RWED,GR:R,WO: 
PROT = SY : RWE D,OW: RWED.G R : RWE D,WO: 



COMMANDS 



SYSTEM 



OWNER 



GROUP 



CT 



[5,6] 



[305,303] 



[305,304] 



WORLD 



[200,20] 



COPY PAYROLL.TSK 
[UIC] NEW.TSK 



ACCESS = YES 



ACCESS = YES 



ACCESS = YES 



ACCESS = NO 



DEL [305,303] 
PAYROLL.TSK 



NO 



YES 



NO 



NO 



RUN [305,303] 
PAYROLL.TSK 



YES 



YES 



YES 



NO 



TYPE [305,303] 
VIP.MAC 



NO 



YES 



NO 



NO 



EDIT/EDT [305,303] 
LOGIN.CMD 



YES 



YES 



YES 



NO 



Figure 4-5 Accessing a File 



LEARNING ACTIVITIES 

READ the Section on File Protection and 
Volume Protection, in Chapter 4 of the 
RSX-11M/M-PLUS Command Language Manual . 

DO the Written Exercises for this module. 

DO the Lab Exercises for this module. 
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Table 4-7 Equivalent 

OCL Command 
DIR/FULL PAYROLL. CBL 
DIR/SUMMARY 

DIR/OUTPUT: DIRECTORY. LST 
DIR/FREE DB0: 

DEL/LOG A. OBJ;* 
DEL/QUERY *.MAC;* 

PURGE/LOG A .MAC / B . * 
PURGE/KEEP: 3 C.LST 
COPY VI P. MAC [30 5, 304] VI P. MAC 
COPY VIP.TSK,PROG.TSK 

RENAME A.MAC B.MAC 

SET PROTECTION NEW. TXT 

CODE ? ( S Y : RWED , OW : RWED , GR : RWED , WO : R ) 

COPY/OWN NEW. TXT [ 30 5 , 304 ] NEW . TXT 



File Maintenance Commands 
Equivalent MCR Command 

PIP VIP. MAC/LI 

PIP PAYROLL. CBL/FU 

PIP [305,304]/LI 

PIP DIRECTORY. LST=/LI 

PIP VIP.MAC;*/DE 
PIP A.OBJ;*/DE/LD 
PIP *.MAC;*/SD 

PIP A.MAC f B.*/PU/LD 
PIP C.LST/PU:3 

PIP [305,304] VIP. MAC/NV=VI P. MAC 
PIP [305,304]*.*/NV=VIP.TSK,- 

PIP B. MAC =A. MAC/RE 
PIP TI:=NEW.TXT 

PIP NEW.TXT/PR/SY:RWED/OW:RWED- 
/GR:RWED/WO:R 

PIP [305,304]NEW. TXT/N V/FO=N EW . TXT 
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